{"applicazione":"FacilePay ONE \u2014 API","nota":"Le regole del denaro stanno nel database. Questa applicazione traduce HTTP in chiamate di funzione e riporta indietro le parole del database.","rotte":[{"metodo":"GET","percorso":"\/api\/superficie","funzione":"api.superficie","argomenti":[],"descrizione":"Tutto cio che questa API puo fare, secondo il database stesso."},{"metodo":"GET","percorso":"\/api\/cosa-vedo","funzione":"api.cosa_vedo","argomenti":[],"descrizione":"Chi sono, che ruoli ho, quanto vedo. La prima cosa da chiamare quando qualcuno dice \u00abnon vedo i miei dati\u00bb."},{"metodo":"GET","percorso":"\/api\/le-mie-sessioni","funzione":"api.le_mie_sessioni","argomenti":[],"descrizione":"Dove sono entrato: il modo in cui una persona si accorge di un accesso che non ha fatto lei."},{"metodo":"GET","percorso":"\/api\/poteri","funzione":"api.i_miei_poteri","argomenti":[],"descrizione":"Chi sei, di chi, dove: una riga per concessione. Esiste perche chi chiama non debba tenere una seconda tabella dei permessi."},{"metodo":"GET","percorso":"\/api\/sedi","funzione":"api.le_sedi","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":true}},"descrizione":"Le sedi di un esercente per cui si ha un potere."},{"metodo":"GET","percorso":"\/api\/servizi","funzione":"api.i_miei_servizi","argomenti":[],"descrizione":"I servizi della persona: portafogli, portale consulente."},{"metodo":"GET","percorso":"\/api\/esercente\/servizi","funzione":"api.servizi_esercente","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":true}},"descrizione":"Attivi, da attivare, bloccati e richiedibili in una risposta sola: due elenchi separati diventano due schermate, e nessuna risponde a \u00abcosa posso fare oggi\u00bb."},{"metodo":"POST","percorso":"\/api\/servizi\/chiedi","funzione":"api.chiedi_servizio","argomenti":{"p_codice":{"tipo":"text","da":"corpo","obbligatorio":true},"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":false}},"descrizione":"Chiede un servizio. Chiedere non e attivare: decide la piattaforma."},{"metodo":"GET","percorso":"\/api\/saldo","funzione":"api.mio_saldo","argomenti":{"p_unit_code":{"tipo":"text","da":"query","obbligatorio":false}},"descrizione":"Saldo contabile, disponibile e spendibile: tre numeri diversi, e la differenza conta."},{"metodo":"GET","percorso":"\/api\/buoni","funzione":"api.i_miei_buoni","argomenti":{"p_unit_code":{"tipo":"text","da":"query","obbligatorio":false}},"descrizione":"I lotti in vita e quando scadono, dal piu vicino: e l'ordine in cui verranno spesi."},{"metodo":"GET","percorso":"\/api\/capienza","funzione":"api.mia_capienza","argomenti":{"p_unit_code":{"tipo":"text","da":"query","obbligatorio":false}},"descrizione":"Quanto si puo ancora ricaricare nei trenta giorni mobili."},{"metodo":"GET","percorso":"\/api\/capienza\/quando","funzione":"api.quando_torna_capienza","argomenti":{"p_unit_code":{"tipo":"text","da":"query","obbligatorio":false}},"descrizione":"Il giorno in cui il tetto si libera. Un limite che non si sa spiegare sembra un guasto."},{"metodo":"GET","percorso":"\/api\/movimenti","funzione":"api.i_miei_movimenti","argomenti":{"p_unit_code":{"tipo":"text","da":"query","obbligatorio":false},"p_quanti":{"tipo":"integer","da":"query","obbligatorio":false}},"descrizione":"I propri movimenti, col verso in parole e il nome di chi c'e dall'altra parte. La colonna \u00abscrittura\u00bb e l'argomento di api.contesta(): senza di essa il diritto di contestare esisteva senza una strada per esercitarlo."},{"metodo":"GET","percorso":"\/api\/negozi","funzione":"api.dove_posso_spendere","argomenti":{"p_unit_code":{"tipo":"text","da":"query","obbligatorio":false}},"descrizione":"Gli esercenti che possono accettare questa unita: servizio attivo E conto nell'unita. Un marketplace che mostra un negozio che non accetta e una promessa che qualcun altro deve mantenere."},{"metodo":"POST","percorso":"\/api\/spendi","funzione":"api.spendi","argomenti":{"p_a_conto":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true}},"descrizione":"Paga un esercente. Il conto che paga non e un argomento: lo deduce il database da chi chiama."},{"metodo":"POST","percorso":"\/api\/autorizza","funzione":"api.autorizza","argomenti":{"p_a_conto":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true},"p_card_id":{"tipo":"uuid","da":"corpo","obbligatorio":false},"p_circuit_id":{"tipo":"uuid","da":"corpo","obbligatorio":false},"p_carta_presente":{"tipo":"boolean","da":"corpo","obbligatorio":false},"p_durata":{"tipo":"interval","da":"corpo","obbligatorio":false}},"descrizione":"Blocca un importo senza muoverlo. Scade da se, e la carta presente cambia chi risponde in caso di contestazione."},{"metodo":"POST","percorso":"\/api\/cattura","funzione":"api.cattura","argomenti":{"p_auth_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true}},"descrizione":"Incassa un'autorizzazione, anche solo in parte."},{"metodo":"POST","percorso":"\/api\/annulla-autorizzazione","funzione":"api.annulla_autorizzazione","argomenti":{"p_auth_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Libera un importo bloccato, con il motivo."},{"metodo":"GET","percorso":"\/api\/esercente\/situazione","funzione":"api.situazione_esercente","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":true}},"descrizione":"Cosa ha in cassa un esercente, per unita, e quali uscite ha."},{"metodo":"POST","percorso":"\/api\/esercente\/liquidazione","funzione":"api.chiedi_liquidazione","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true},"p_circuit_id":{"tipo":"uuid","da":"corpo","obbligatorio":false}},"descrizione":"Chiede euro. Torna lordo, commissione, IVA e netto con la spiegazione del conto."},{"metodo":"POST","percorso":"\/api\/esercente\/crediti","funzione":"api.converti_in_crediti","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true},"p_circuit_id":{"tipo":"uuid","da":"corpo","obbligatorio":false}},"descrizione":"Trasforma il buono in crediti business, che non scadono e pagano servizi e altri esercenti."},{"metodo":"POST","percorso":"\/api\/esercente\/paga-esercente","funzione":"api.paga_esercente","argomenti":{"p_da_merchant":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_a_merchant":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true}},"descrizione":"Un esercente paga un altro esercente in crediti business."},{"metodo":"POST","percorso":"\/api\/esercente\/paga-servizio","funzione":"api.paga_servizio","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true},"p_servizio":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Paga un servizio della piattaforma con i crediti business."},{"metodo":"POST","percorso":"\/api\/esercente\/coordinate","funzione":"api.registra_coordinate","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_iban":{"tipo":"text","da":"corpo","obbligatorio":true},"p_intestatario":{"tipo":"text","da":"corpo","obbligatorio":true},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":true},"p_bic":{"tipo":"text","da":"corpo","obbligatorio":false},"p_banca":{"tipo":"text","da":"corpo","obbligatorio":false}},"descrizione":"Dichiara dove incassare. Nasce \u00abda verificare\u00bb: la verifica non passa da qui, ed e voluto."},{"metodo":"GET","percorso":"\/api\/esercente\/dispositivi","funzione":"api.i_miei_dispositivi","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":true}},"descrizione":"Le casse di un esercente: il modo in cui si accorge di una cassa che non riconosce, o di una che lavora di notte."},{"metodo":"POST","percorso":"\/api\/mio-pin","funzione":"api.imposta_mio_pin","argomenti":{"p_pin":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Il proprio PIN per le casse, da quattro a otto cifre. Lo mette ciascuno per se: un PIN che qualcun altro conosce non identifica nessuno, e alla cassa serve sapere CHI ha battuto lo scontrino."},{"metodo":"GET","percorso":"\/api\/provvigioni","funzione":"api.le_mie_provvigioni","argomenti":{"p_quante":{"tipo":"integer","da":"query","obbligatorio":false}},"descrizione":"Le proprie provvigioni, con la BASE e la QUOTA oltre all'importo: un consulente che vede \u00ab12,50\u00bb e non sa su quanto telefona, e chi risponde deve ricostruire il piano vigente a quella data per dirglielo."},{"metodo":"GET","percorso":"\/api\/consulente\/esercenti","funzione":"api.i_miei_esercenti_assegnati","argomenti":[],"descrizione":"Gli esercenti assegnati, con quanto si e maturato su ciascuno e quanto resta da pagare."},{"metodo":"GET","percorso":"\/api\/esercente\/consulenti","funzione":"api.consulenti_di","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":true}},"descrizione":"I consulenti di un esercente, anche quelli chiusi: cio che hanno maturato resta loro, e la storia serve a spiegare un importo."},{"metodo":"POST","percorso":"\/api\/consulente\/assegna","funzione":"api.assegna_consulente","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_subject":{"tipo":"text","da":"corpo","obbligatorio":true},"p_circuit_id":{"tipo":"uuid","da":"corpo","obbligatorio":false}},"descrizione":"Assegna un consulente a un esercente. Solo la piattaforma, e RIFIUTA la seconda assegnazione attiva: due consulenti fermerebbero le liquidazioni, e il motivo si scoprirebbe settimane dopo."},{"metodo":"POST","percorso":"\/api\/consulente\/chiudi","funzione":"api.chiudi_assegnazione","argomenti":{"p_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Chiude un assegnazione. La riga resta, e con essa le provvigioni maturate: chiudere non e cancellare."},{"metodo":"GET","percorso":"\/api\/autorizzazioni","funzione":"api.autorizzazioni","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":false},"p_quante":{"tipo":"integer","da":"query","obbligatorio":false}},"descrizione":"Le autorizzazioni, dalla piu urgente: prima le aperte, e fra quelle prima quelle che scadono presto."},{"metodo":"POST","percorso":"\/api\/autorizzazioni\/cattura","funzione":"api.cattura","argomenti":{"p_auth_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true}},"descrizione":"Registra il movimento. Catturare meno di quanto autorizzato libera subito il resto."},{"metodo":"POST","percorso":"\/api\/autorizzazioni\/annulla","funzione":"api.annulla_autorizzazione","argomenti":{"p_auth_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Libera l impegno senza registrare niente: non era un pagamento, era una prenotazione."},{"metodo":"GET","percorso":"\/api\/piano","funzione":"api.piano_vigente","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":false},"p_circuit_id":{"tipo":"uuid","da":"query","obbligatorio":false}},"descrizione":"Quale piano economico si applica, davvero: la stessa scelta che fa la liquidazione, non una ricostruzione."},{"metodo":"GET","percorso":"\/api\/piano\/elenco","funzione":"api.piani","argomenti":{"p_storici":{"tipo":"boolean","da":"query","obbligatorio":false}},"descrizione":"Tutti i piani, bozze comprese, con scritto quale vale: una bozza esiste e si legge, ma non muove un centesimo."},{"metodo":"GET","percorso":"\/api\/piano\/prova","funzione":"api.prova_commissione","argomenti":{"p_lordo_minore":{"tipo":"numeric","da":"query","obbligatorio":true},"p_merchant_id":{"tipo":"uuid","da":"query","obbligatorio":false},"p_circuit_id":{"tipo":"uuid","da":"query","obbligatorio":false}},"descrizione":"Cosa diventa un importo vero: una percentuale non dice quasi niente, \u00ab2,50 di fee e 96,95 all esercente\u00bb si discute."},{"metodo":"POST","percorso":"\/api\/piano\/proponi","funzione":"api.proponi_piano","argomenti":{"p_bersaglio":{"tipo":"text","da":"corpo","obbligatorio":true},"p_valore":{"tipo":"uuid","da":"corpo","obbligatorio":false},"p_percentuale":{"tipo":"numeric","da":"corpo","obbligatorio":false},"p_fissa_minore":{"tipo":"numeric","da":"corpo","obbligatorio":false},"p_iva_modo":{"tipo":"text","da":"corpo","obbligatorio":false},"p_aliquota":{"tipo":"numeric","da":"corpo","obbligatorio":false},"p_giorni":{"tipo":"integer","da":"corpo","obbligatorio":false},"p_eur_per_evo":{"tipo":"numeric","da":"corpo","obbligatorio":false},"p_validita_giorni":{"tipo":"integer","da":"corpo","obbligatorio":false},"p_quota_fee_bp":{"tipo":"integer","da":"corpo","obbligatorio":false},"p_quota_licenza_bp":{"tipo":"integer","da":"corpo","obbligatorio":false},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":false},"p_valido_da":{"tipo":"date","da":"corpo","obbligatorio":false},"p_valido_fino":{"tipo":"date","da":"corpo","obbligatorio":false}},"descrizione":"Una bozza. Cio che non si passa si EREDITA dal piano in vigore: cambiare la quota del consulente non deve costringere a ricopiare commissione, IVA, giorni e tasso."},{"metodo":"POST","percorso":"\/api\/piano\/approva","funzione":"api.approva_piano","argomenti":{"p_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_nota":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Mette un piano in vigore. La ragione scritta e obbligatoria: fra sei mesi \u00abperche\u00bb e la sola domanda a cui nessun numero risponde."},{"metodo":"POST","percorso":"\/api\/piano\/sospendi","funzione":"api.sospendi_piano","argomenti":{"p_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Toglie un piano dal vigore. Non lo cancella: le liquidazioni che ha calcolato restano, e restano spiegate da lui."},{"metodo":"GET","percorso":"\/api\/consulente\/da-pagare","funzione":"api.provvigioni_da_pagare","argomenti":[],"descrizione":"Chi va pagato, in ordine di ATTESA e non di importo: chi aspetta da tre mesi e il problema."},{"metodo":"POST","percorso":"\/api\/consulente\/paga","funzione":"api.paga_provvigioni","argomenti":{"p_subject":{"tipo":"text","da":"corpo","obbligatorio":true},"p_fino_al":{"tipo":"date","da":"corpo","obbligatorio":true},"p_riferimento":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Paga in una scrittura le provvigioni maturate fino a una data. Il riferimento del bonifico e obbligatorio: senza, la riconciliazione non lo abbinera mai."},{"metodo":"POST","percorso":"\/api\/esercente\/canone","funzione":"api.registra_canone","argomenti":{"p_merchant_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_importo_minore":{"tipo":"numeric","da":"corpo","obbligatorio":true},"p_licenza":{"tipo":"text","da":"corpo","obbligatorio":true},"p_chiave":{"tipo":"text","da":"chiave","obbligatorio":true}},"descrizione":"Il portale dice al nucleo che un esercente ha pagato un canone, e il nucleo attribuisce la quota del consulente. Solo la piattaforma: chi guadagna sul canone non puo dichiararlo."},{"metodo":"POST","percorso":"\/api\/contesta","funzione":"api.contesta","argomenti":{"p_journal_id":{"tipo":"uuid","da":"corpo","obbligatorio":true},"p_motivo":{"tipo":"text","da":"corpo","obbligatorio":true},"p_descrizione":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"Apre una contestazione su un movimento. Il termine parte da adesso."},{"metodo":"GET","percorso":"\/api\/contestazioni","funzione":"api.le_mie_contestazioni","argomenti":[],"descrizione":"Le mie contestazioni e a che punto sono."},{"metodo":"POST","percorso":"\/api\/contestazioni\/rispondi","funzione":"api.rispondi_contestazione","argomenti":{"p_numero":{"tipo":"bigint","da":"corpo","obbligatorio":true},"p_risposta":{"tipo":"text","da":"corpo","obbligatorio":true}},"descrizione":"La risposta dell'esercente. Se non arriva entro il termine, il cliente vince da se."}]}