Sincronização de documentos

O que mudou neste lado do espaço de trabalho, do mais antigo para o mais recente. Um evento indica um documento, nunca o conteúdo dele: leia o documento com a operação correspondente, para sempre receber a versão atual. Devolva nextCursor como after na próxima chamada; enquanto hasMore for true, chame de novo imediatamente. Os eventos ficam guardados por 30 dias e são entregues pelo menos uma vez, então a mesma mudança pode chegar duas vezes; os 5 segundos mais recentes aguardam a próxima chamada. Quem chama como Fornecedor recebe purchase_order.issued, changed, canceled e rejected, invoice.received, approved, rejected, paid, payment_withdrawn, remittance_sent e credit_applied, invoice.updated (um comprador colocou a fatura em espera para revisão, ou a liberou: leia GetInvoiceStatus), e credit_note.accepted e rejected. Quem chama como Comprador recebe invoice.received e credit_note.received (um fornecedor enviou um documento); invoice.updated (uma fatura foi aprovada, por uma pessoa ou automaticamente, ou rejeitada, ou o fornecedor dela confirmou ou denunciou os dados bancários); invoice.payment (um pagamento foi registrado ou retirado, um crédito quitou a fatura, ou um pagamento pela Pleaxy foi concluído ou falhou: leia GetInvoiceRemittance); purchase_order.updated (um pedido foi aprovado, rejeitado ou cancelado); e purchase_order.confirmed e purchase_order.shipped (leia GetPurchaseOrderFulfillment). Recebe só os tipos de documento que a sua função de compras pode ver.

Um pedido de compra emitido como documento que o seu sistema importa. format=cxml (o padrão) é um OrderRequest do cXML: tipo new, update a partir da versão 2, delete depois de cancelado. format=ubl é um Order do UBL 2.1, ou um OrderCancellation depois de cancelado. As duas partes são identificadas pelos IDs dos seus espaços de trabalho. É a cópia do fornecedor, seja quem for que peça. Um fornecedor cujos compradores compartilham um id de pedido adiciona ?buyer=<ID do espaço de trabalho do comprador>.

Uma fatura como Invoice do UBL 2.1 (tipo 380, ou 383 para uma nota de débito), para o ERP do comprador lançar ou para o arquivo do fornecedor: as linhas, os descontos e cobranças no nível do documento, impostos e retenções, adiantamentos, as instruções de pagamento do fornecedor, e o pedido e o contrato que ela cobra. Os totais batem com o valor da fatura. É a visão do fornecedor, seja quem for que peça: sem conciliação, apontamentos ou aprovações.

A situação de uma fatura, para o sistema que a enviou ou para o que a paga, como um status com os códigos que os sistemas de faturamento eletrônico usam para ele. O equivalente em cXML ou UBL é GetInvoiceStatusDocument. É a visão do fornecedor, seja quem for que peça.

GetInvoiceStatus como documento. format=cxml (o padrão) é um StatusUpdateRequest do cXML com um InvoiceStatus; format=ubl é um ApplicationResponse do UBL 2.1 com os códigos da Peppol Invoice Response e, para uma rejeição, o motivo.

O sinal de pagamento de uma fatura, para a conciliação de recebimentos do fornecedor: como e quando o comprador pagou, a referência, o que foi retido e o que chegou ao fornecedor, e os avisos de pagamento que o comprador enviou (observações e comprovantes de pagamento; GetRemittanceFile baixa um). A Pleaxy registra o que o comprador declara e não movimenta dinheiro. Nunca quem, do lado do comprador, o registrou. O equivalente em cXML ou UBL é GetInvoiceRemittanceDocument.

GetInvoiceRemittance como documento. format=cxml (o padrão) é um PaymentRemittanceRequest do cXML; format=ubl é um RemittanceAdvice do UBL 2.1.

Registra pagamentos que o seu ERP ou feed bancário já fez fora da Pleaxy - transferências, cheques, ACH, cartão - para que cada fornecedor receba a notificação de pagamento, o aviso de pagamento e o evento de sincronização sem que ninguém redigite nada. Isto não movimenta dinheiro. Cada pagamento segue as regras de RecordPayment e é respondido individualmente; repetir um é seguro (already_recorded). Uma fatura aprovada por uma chave de API continua sendo recusada. note vira uma observação de aviso de pagamento para o fornecedor; um comprovante de pagamento só pode ser anexado por uma pessoa.

Só chave de API de comprador com o escopo payments:record, criada com uma procurementRole que possa editar faturas (administrator ou finance). Uma pessoa conectada usa RecordPayment.