Pular para o conteúdo
PlaidCloud

Xero: Lançar documento

Descrição

Seção intitulada “Descrição”

Lança documentos no Xero através da sua ligação Xero, encaminhados pelo pipeline partilhado de escrita ERP do PlaidCloud. O passo recebe uma tabela de cabeçalho (uma linha por documento) e uma tabela de linhas (uma ou mais linhas por documento) e lança cada documento como ManualJournal, Invoice, Bill, Payment ou CreditNote. Um lote pode misturar tipos de documento — o PlaidCloud divide-o por tipo de documento antes de qualquer chamada de rede. O Modo apenas de teste constrói e verifica todos os documentos sem reservar no livro-razão e sem lançar; uma tabela de resultados opcional regista o resultado de cada documento.

Configuração

Seção intitulada “Configuração”

Ligação Xero

Seção intitulada “Ligação Xero”
  • Ligação Xero — a ligação Xero através da qual lançar. Transporta a organização em que todos os documentos são lançados.
  • Ambiente — o ambiente do PlaidCloud da ligação através do qual lançar, o mesmo seletor que todos os passos baseados em ligações têm. Não tem relação com a Demo Company do próprio Xero, que é uma propriedade da organização para a qual a ligação aponta.
  • Modo apenas de teste — assinalado por predefinição. Valida cada documento mas não o lança: sem reserva no livro-razão e sem escrita. Uma configuração de passo que omita totalmente este campo — por exemplo, criada através da API REST, do MCP ou de uma importação de pacote de fluxo de trabalho — também assume por predefinição o Modo apenas de teste, em vez de um lançamento real.
  • Continuar a lançar os restantes documentos se um documento falhar — assinalado por predefinição. Se desassinalado, o lote pára na primeira falha.
  • Tabela de resultados — uma linha por documento: ref, doc_type, natural_key, xero_id, status (posted/validated/error) e message.

Seleção de tabelas

Seção intitulada “Seleção de tabelas”
  • Tabela de cabeçalho — uma linha por documento.
  • Tabela de linhas — uma ou mais linhas por documento, associadas ao cabeçalho por ref.

Campos do cabeçalho e das linhas

Seção intitulada “Campos do cabeçalho e das linhas”

Dois separadores de mapeamento associam os nomes das suas próprias colunas aos campos de que o Xero necessita. Campos do cabeçalho abrange:

Campo Notas
ref Obrigatório. A sua chave de negócio — liga as linhas do cabeçalho às respetivas linhas e é a chave que o livro de idempotência reserva.
doc_type Obrigatório. ManualJournal, Invoice, Bill, Payment ou CreditNote.
posting_date Obrigatório.
currency_id, party_id, memo, due_date Opcionais. party_id é o contacto Xero.
total_amt, deposit_account_id, bank_account_id, linked_invoice_id Apenas para pagamentos, opcionais.
credit_note_type Apenas para notas de crédito, opcional. ACCRECCREDIT (vendas, o valor predefinido) ou ACCPAYCREDIT (compras).

Campos das linhas abrange ref (obrigatório, a corresponder a uma linha do cabeçalho), além dos campos de que o tipo de documento necessita:

Tipo de documento Campos das linhas
ManualJournal account_id, debit, credit e, opcionalmente, class_id / department_id para acompanhamento
Invoice item_id, qty, unit_price, amount
Bill account_id, amount
CreditNote item_id, qty, unit_price, amount
Payment linked_txn_id (a fatura a que a linha se aplica), amount

tax_type e memo são opcionais em todas as linhas.

Como funciona o lançamento

Seção intitulada “Como funciona o lançamento”

Cada documento é reservado no livro de idempotência do PlaidCloud antes de ser submetido, pelo que uma nova execução nunca lança um documento que já tenha atingido posted. A chave do livro tem como prefixo o tipo de documento, pelo que uma fatura e uma fatura de fornecedor com o mesmo ref nunca colidem, mesmo que o Xero lance ambas através do mesmo ponto de acesso.

Quando um resultado é ambíguo — um tempo limite esgotado, uma resposta perdida — o PlaidCloud consulta o Xero pelo número de documento que atribuiu: um número de fatura para uma fatura ou uma fatura de fornecedor, um número de nota de crédito para uma nota de crédito. Uma correspondência só conta como prova quando o documento se encontra num estado de lançamento terminal, uma vez que esses números não têm unicidade garantida no Xero — uma correspondência em rascunho, anulada ou com número duplicado é tratada como não resolvida e colocada em quarentena, em vez de ser registada como resultado desta escrita.

Limites de capacidade

Seção intitulada “Limites de capacidade”
Limitação O que significa
Os lançamentos manuais de diário e os pagamentos não podem ser consultados A descrição de um lançamento manual de diário e a referência de um pagamento não são consultáveis no Xero, pelo que não existe nenhum campo para associar uma escrita em dúvida ao pedido. Esses casos são colocados em quarentena para resolução manual, em vez de serem adivinhados.
A reversão abrange lançamentos manuais de diário e faturas Um lançamento manual de diário é revertido como um lançamento com débito/crédito trocados; uma fatura é revertida como uma nota de crédito espelho. As faturas de fornecedor, os pagamentos e as notas de crédito não têm uma carga de anulação documentada, pelo que a reversão é recusada, nunca simulada.
Os limites de taxa são por organização O Xero permite 60 chamadas por minuto e 5000 por dia por organização, com 5 chamadas em simultâneo. O PlaidCloud controla os limites por minuto e de simultaneidade e recua perante uma resposta de limitação; um lote muito grande demora proporcionalmente mais tempo.

Ver também

Seção intitulada “Ver também”