Pular para o conteúdo
PlaidCloud

Acumatica: Post Documents

Descrição

Seção intitulada “Descrição”

Lança documentos no Acumatica através da sua ligação Acumatica, 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 JournalTransaction, SalesInvoice, Bill ou Payment. Validate Only constrói e verifica todos os documentos sem reserva no livro e sem lançar; uma tabela de resultados opcional regista o resultado de cada documento.

Configuração

Seção intitulada “Configuração”

Ligação

Seção intitulada “Ligação”
  • Ligação Acumatica — a ligação Acumatica através da qual lançar.
  • Ambiente — o ambiente da ligação.

Dados

Seção intitulada “Dados”

  • Tabela de cabeçalho — uma linha por documento: ref (o identificador do seu documento, obrigatório), doc_type (JournalTransaction/SalesInvoice/Bill/Payment, obrigatório), posting_date, party_id (cliente/fornecedor, quando o tipo de documento exige um), memo, due_date, branch_id. Um lote pode misturar tipos de documento — o PlaidCloud reparte por doc_type antes de lançar.

  • Tabela de linhas — uma ou mais linhas por ref, adequadas ao tipo de documento:

    Tipo de documento Colunas de linha
    JournalTransaction account, subaccount, branch, debit, credit
    SalesInvoice item, qty, unit_price, amount
    Bill account, amount
    Payment linked_txn_id, amount

  • Tabela de resultados — id da tabela de saída: uma linha por documento com ref, doc_type, natural_key, confirmation_id, status (posted/validated/error), message.

  • Validate Only — selecionado por predefinição. Apenas verificação prévia; sem reserva no livro, sem lançamento. Uma configuração de passo que omita totalmente este campo — por exemplo, uma criada através da API REST, do MCP ou da importação de um pacote de fluxo de trabalho — também assume Validate Only como predefinição em vez de um lançamento real.

  • Continue On Error — selecionado por predefinição. Continua a lançar os restantes documentos depois de um falhar; se estiver desmarcado, interrompe o lote à primeira falha.

Como funciona o lançamento

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

O Acumatica cria todos os documentos em Hold e, em seguida, o PlaidCloud chama a ação de libertação, que é executada de forma assíncrona — uma resposta 202 aceite, consultada até à conclusão, seguida de um 204 que confirma a libertação. O PlaidCloud só comunica posted quando a libertação é confirmada ao reler o indicador Hold do documento como falso — um documento que é criado mas cuja libertação nunca é confirmada permanece em quarentena (não é comunicado como lançado, nem descartado em silêncio) em vez de ser registado como êxito apenas porque o documento existe.

Limites de capacidade

Seção intitulada “Limites de capacidade”
Limitação O que significa
Sem chave de idempotência nativa A API de escrita do Acumatica, baseada em PUT, não tem campo de idempotência. A reserva no livro do próprio PlaidCloud, e não uma chave do lado do Acumatica, é a única proteção contra um lançamento duplicado numa repetição ou nova execução.
A reversão é manual Nenhum tipo de documento tem uma ação de anulação/reversão documentada na API baseada em contrato. reversal_mode é NONE em todos os casos — recusada, nunca simulada. Corrija um documento lançado incorretamente diretamente no Acumatica.
O pagamento não tem pesquisa fiável Nenhum campo documentado correlaciona um Payment com o pedido do PlaidCloud depois de um resultado ambíguo. Um Payment em dúvida fica em quarentena para resolução manual em vez de ser adivinhado.
A filtragem de itens de linha não é feita no servidor Os filtros do lado do servidor (no passo de importação) não chegam às dimensões dos itens de linha de um documento — filtre ao nível do cabeçalho/entidade e delimite as linhas no seu fluxo de trabalho.

Relacionado

Seção intitulada “Relacionado”