Sage Intacct: Attach Document

Descrição

Anexa documentos de suporte a registos do Sage Intacct através da sua ligação Sage Intacct, encaminhados pelo pipeline de escrita ERP partilhado do PlaidCloud. Cada linha da tabela de origem é um ficheiro — os seus bytes, o seu nome e a chave do registo do Intacct ao qual se anexa — que o passo cria como documento de suporte do Sage Intacct (supdoc) e associa a esse registo. Validate Only verifica todas as linhas sem criar nada no Intacct; a tabela de resultados regista o desfecho por anexo.

Utilize-o para enviar ficheiros que um fluxo de trabalho já tem à mão — um PDF de fatura gerado, um recibo digitalizado, um relatório exportado — para as transações ou registos do Intacct a que pertencem, na mesma execução que os produz ou lança. Combina naturalmente com Intacct: Lançar lançamento de diário: lance os lançamentos e depois anexe o respetivo suporte com a chave do Intacct devolvida por cada lançamento.

Contrato da estrutura de dados

Crie a tabela de anexos a montante com passos padrão, de modo que cada linha seja um ficheiro completo associado a um registo:

parent_key — o registo do Sage Intacct ao qual o ficheiro se anexa. Um ficheiro, um registo principal por linha; para anexar o mesmo ficheiro a vários registos, repita-o em várias linhas.
file_name — o nome de ficheiro do documento de suporte, incluindo a extensão (invoice-1043.pdf).
mime_type — o tipo de conteúdo do ficheiro (application/pdf, image/png), para que o Intacct o guarde e o disponibilize corretamente.
content_base64 — os bytes do ficheiro, codificados em base64, na linha.

Configuração

Ligação

Ligação Sage Intacct — a ligação Sage Intacct através da qual se anexa. Só são apresentadas ligações Sage Intacct; a mesma ligação lê e escreve no Intacct.
Ambiente — o ambiente da ligação.

Dados

Tabela de anexos — a tabela de origem descrita acima: uma linha por ficheiro, com parent_key, file_name, mime_type e content_base64.
Tabela de resultados — id da tabela de saída: uma linha por anexo com parent_key, file_name, supdoc_id, status, message.
Validate Only — selecionado por predefinição. Apenas verificação prévia; verifica cada linha e grava a tabela de resultados, mas não cria nenhum documento de suporte no Intacct. 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 Validate Only, em vez de um anexo real.
Continue On Error — selecionado por predefinição. Continua a anexar os restantes ficheiros depois de um falhar; se estiver desmarcado, pára na primeira falha.

Tabela de resultados

Todas as execuções — Validate Only ou reais — gravam uma linha por linha de origem na tabela de resultados:

Coluna	Descrição
`parent_key`	O registo do Intacct a que este anexo se destina.
`file_name`	O nome do ficheiro da linha de origem.
`supdoc_id`	O id do documento de suporte do Sage Intacct criado para o ficheiro, quando o anexo foi bem-sucedido.
`status`	O desfecho desta linha — validado, anexado ou falhado.
`message`	Uma descrição curta e higienizada do que correu mal, quando a linha falhou.