Sincronizzazione dei documenti

Cosa è cambiato in questa parte del workspace, dal meno recente. Un evento indica un documento, mai il suo contenuto: leggi il documento con l’operazione apposita, così ottieni sempre la versione attuale. Ripassa nextCursor come after nella chiamata successiva; finché hasMore è true, richiama subito. Gli eventi sono conservati 30 giorni e consegnati almeno una volta, quindi la stessa modifica può arrivare due volte; gli ultimi 5 secondi attendono la chiamata successiva. Un chiamante Fornitore riceve purchase_order.issued, changed, canceled e rejected, invoice.received, approved, rejected, paid, payment_withdrawn, remittance_sent e credit_applied, invoice.updated (un acquirente ha messo in sospeso la fattura per verificarla, o l’ha sbloccata: leggi GetInvoiceStatus), e credit_note.accepted e rejected. Un chiamante Acquirente riceve invoice.received e credit_note.received (un fornitore ha inviato una fattura o una nota di credito); invoice.updated (una fattura è stata approvata, da una persona o automaticamente, o rifiutata, oppure il suo fornitore ne ha confermato le coordinate bancarie o l’ha segnalata); invoice.payment (un pagamento è stato registrato o ritirato, un credito ha saldato la fattura, oppure un pagamento tramite Pleaxy è andato a buon fine o non è riuscito: leggi GetInvoiceRemittance); purchase_order.updated (un ordine è stato approvato, rifiutato o annullato); e purchase_order.confirmed e purchase_order.shipped (leggi GetPurchaseOrderFulfillment). Riceve solo i tipi di documento che il suo ruolo procurement può vedere.

Un ordine d’acquisto emesso come documento che il tuo sistema può importare. format=cxml (predefinito) è un OrderRequest cXML: tipo new, update dalla versione 2, delete una volta annullato. format=ubl è un Order UBL 2.1, oppure un OrderCancellation una volta annullato. Entrambe le parti sono indicate dai loro ID del workspace. È la copia del fornitore, chiunque la richieda. Un fornitore i cui acquirenti condividono un id di OdA aggiunge ?buyer=<buyer Workspace ID>.

Una fattura come Invoice UBL 2.1 (tipo 380, o 383 per una nota di debito), da registrare nell’ERP dell’acquirente o per l’archivio del fornitore: le righe, gli sconti e gli addebiti a livello di documento, imposte e ritenute, gli acconti, le istruzioni di pagamento del fornitore, e l’OdA e il contratto che fattura. I totali corrispondono all’importo della fattura. È la vista del fornitore, chiunque la richieda: niente abbinamento, rilievi o approvazioni.

Lo stato di una fattura, per il sistema che l’ha inviata o per quello che la paga, come un unico stato con i codici che usano i sistemi di fatturazione elettronica. L’equivalente in cXML o UBL è GetInvoiceStatusDocument. È la vista del fornitore, chiunque la richieda.

GetInvoiceStatus come documento. format=cxml (predefinito) è uno StatusUpdateRequest cXML con un InvoiceStatus; format=ubl è un ApplicationResponse UBL 2.1 con i codici della Peppol Invoice Response e, per un rifiuto, il suo motivo.

Il segnale di pagamento di una fattura, per la riconciliazione degli incassi del fornitore: come e quando l’acquirente ha pagato, il riferimento, cosa è stato trattenuto e cosa è arrivato al fornitore, e gli avvisi di pagamento inviati dall’acquirente (note e prove di pagamento; GetRemittanceFile ne scarica uno). Pleaxy registra ciò che l’acquirente dichiara e non sposta denaro. Mai chi, presso l’acquirente, l’ha registrato. L’equivalente in cXML o UBL è GetInvoiceRemittanceDocument.

GetInvoiceRemittance come documento. format=cxml (predefinito) è un PaymentRemittanceRequest cXML; format=ubl è un RemittanceAdvice UBL 2.1.

Registra pagamenti che il tuo ERP o il tuo feed bancario ha già effettuato al di fuori di Pleaxy (bonifici, assegni, ACH, carta), così ogni fornitore riceve la notifica di pagamento, l’avviso di pagamento e l’evento di sincronizzazione senza che nessuno li ridigiti. Non sposta denaro. Ogni pagamento segue le regole di RecordPayment e riceve una risposta a sé; ripeterne uno è sicuro (already_recorded). Una fattura approvata da una chiave API viene comunque rifiutata. note diventa una nota dell’avviso di pagamento per il fornitore; una prova di pagamento può essere allegata solo da una persona.

Solo chiave API acquirente con l’ambito payments:record, generata con un procurementRole che può modificare le fatture (administrator o finance). Una persona che ha effettuato l’accesso usa RecordPayment.