Pular para o conteúdo

Lança lançamentos de diário no Sage Intacct através de uma ligação Sage Intacct, utilizando a API REST v1 do Intacct. É uma alternativa nativa e de pouco código à escrita de uma função definida pelo utilizador (UDF) de lançamento — escolha a ligação, mapeie as colunas e o passo trata da autenticação, do processamento em lotes e do tratamento de erros por lançamento.

O passo lê duas tabelas que já tenha preparado a montante — uma tabela de cabeçalho e uma tabela de linhas —, valida cada lançamento de diário e lança-o. Suporta o caso de lotes: muitos lançamentos de diário numa única execução, cada um lançado e acompanhado de forma independente.

Cada lançamento passa pelo registo de lançamentos do PlaidCloud, o mesmo registo que os outros passos de lançamento ERP utilizam, pelo que um lançamento real aparece no Registo de lançamentos e no Histórico de lançamentos ERP. Um lançamento real exige também que o projeto esteja autorizado a lançar na ligação.

O passo não deduz quais as linhas que pertencem a cada lançamento de diário — essa estrutura é criada a montante com passos padrão (uma expressão de atribuição, uma agregação) antes de este passo ser executado:

  • A tabela de cabeçalho tem exatamente uma linha por lançamento de diário, e essa linha inclui uma coluna entry_key — qualquer valor único por lançamento (um número de lote, uma concatenação de data e descrição, uma sequência gerada).
  • A tabela de linhas tem uma linha por linha de lançamento, e todas as linhas incluem o mesmo valor de entry_key da linha de cabeçalho a que pertencem.

Um único lançamento de diário (sem lotes) também precisa desta estrutura — atribua a todas as linhas de ambas as tabelas o mesmo entry_key constante.

O passo agrupa ambas as tabelas por entry_key antes de validar ou lançar, pelo que uma linha de cabeçalho sem linhas correspondentes, uma linha sem cabeçalho correspondente ou mais de uma linha de cabeçalho para a mesma chave falham todas a validação desse lançamento, em vez de produzirem um lançamento malformado.

A ligação Sage Intacct através da qual se lança. Aqui só são apresentadas ligações Sage Intacct — uma ligação REST genérica não é aceite, porque o lançamento exige a troca de tokens e a resolução de empresa/entidade específicas do Intacct, que só uma ligação Sage Intacct inclui.

A mesma ligação é utilizada noutros locais para ler do Intacct (por exemplo, Import Sage AP ou Import Sage Intacct Query) — uma ligação serve nos dois sentidos. Consulte Sage Intacct REST Connector.

O nome da coluna — presente nas colunas de origem do cabeçalho e das linhas — que agrupa as linhas de cabeçalho e de linhas num único lançamento de diário. Consulte o Contrato da estrutura de dados acima.

Dois mapeamentos de colunas distintos, um por separador — em cada um, mapeie uma coluna de origem para o campo do lançamento de diário que ela alimenta:

  • Colunas do cabeçalho — os campos ao nível do lançamento de diário: diário, data de lançamento, descrição, número de referência, um base_location opcional (a entidade/localização do Intacct sob a qual o lançamento é registado — omita-o numa empresa com uma única entidade), a coluna de correlação que indicou como Entry Key e outros detalhes ao nível do cabeçalho. Um reference_number que mapeie é mantido apenas para apresentação: o número de referência enviado ao Intacct é sempre construído a partir da chave do lançamento e do mês de lançamento.
  • Colunas das linhas — os campos por linha de lançamento: conta do razão geral, montante de débito/crédito, descrição da linha, a mesma coluna Entry Key e dimensões (localização, departamento, colaborador, classe e semelhantes).

Não precisa de mudar o nome das colunas de origem — mapeie-as, seja qual for o nome, para os nomes dos campos de destino acima.

A tabela de destino onde este passo grava uma linha por lançamento de diário, registando o desfecho da validação e (se não estiver em Preview) do lançamento. Consulte a Tabela de resultados mais abaixo para ver as colunas e os valores de status.

Uma caixa de seleção, selecionada por predefinição. Com Preview ativado, o passo valida todos os lançamentos de diário e grava a tabela de resultados exatamente como numa execução real, mas não se autentica no Intacct e não lança nada — em modo Preview não há qualquer chamada de rede ao Intacct. As linhas ficam na tabela de resultados com status = preview, mostrando quais os lançamentos que seriam lançados sem problemas e quais falhariam a validação, antes de qualquer coisa chegar ao seu razão geral. O que cada lançamento seria lançado fica também registado como simulado, no Histórico de lançamentos ERP e no Registo de lançamentos; um lançamento simulado nunca bloqueia o lançamento real posterior.

Tal como numa execução real, um Preview substitui a tabela de resultados pelas linhas desta execução — é o resultado do passo em cada execução, não um registo cumulativo —, pelo que um Preview depois de uma execução real substitui as linhas posted e unknown dessa execução. Abra e copie a tabela de resultados da última execução antes de voltar a executar (Preview ou real) se ainda precisar dela.

O Preview não valida as suas credenciais do Intacct — como nunca se liga, uma ligação incorreta ou uma credencial expirada não surgirá aqui. Utilize a ação Testar ligação da ligação (em Tools > Connections) para confirmar as credenciais em separado.

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 Preview, em vez de um lançamento real.

Desmarque Preview apenas quando estiver pronto para um lançamento real. Recomendamos que execute primeiro com Preview ativado, reveja a tabela de resultados e só depois volte a executar com Preview desativado.

Todas as execuções — Preview ou reais — gravam uma linha por lançamento de diário na tabela de resultados:

Coluna Descrição
entry_key O lançamento de diário sobre o qual esta linha informa.
status Um de preview, posted, failed, unknown — veja abaixo.
intacct_key A chave atribuída pelo Intacct ao lançamento registado, quando disponível.
http_status Deixado vazio; status e error_message indicam o desfecho.
error_message Uma descrição curta e higienizada do que correu mal, quando status é failed ou unknown.
line_count Número de linhas associadas a este lançamento.
posting_date A data de lançamento enviada (ou, em Preview, que seria enviada) ao Intacct.
  • preview — modo Preview; o lançamento foi validado e não foi registado.
  • posted — o lançamento foi registado com êxito no Intacct, agora ou numa execução anterior.
  • failed — o lançamento falhou a validação antes de qualquer envio, ou o Intacct rejeitou-o. Corrija uma falha de validação e execute novamente. Um lançamento que o Intacct rejeitou não é enviado novamente com o mesmo entry_key e mês de lançamento, pelo que deve lançar o lançamento corrigido com um novo entry_key.
  • unknown — não foi possível confirmar o desfecho — um tempo limite excedido, uma ligação interrompida ou um erro do servidor sem resposta definitiva do Intacct.

Uma execução com linhas failed ou unknown, ou cujos totais lançados não coincidem com a origem, termina o passo com erro, para que seja visível sem abrir a tabela de resultados. A tabela de resultados e o Registo de lançamentos mostram o que fazer a seguir.