Etapa Import Acumatica Entity

Descrição

Importa uma entidade REST baseada em contrato do Acumatica, pela sua Conexão do Acumatica, para uma tabela de projeto. Escolha a conexão, o tipo de entidade e os filtros; a etapa busca os registros correspondentes e os grava, sem nenhuma consulta OData para escrever.

Esta é uma etapa genérica predefinida — um único tipo de etapa cobre 18 entidades, de dados mestres/de referência (contas, subcontas, clientes, fornecedores, itens de estoque) a registros transacionais (faturas de venda, faturas de fornecedor, pedidos de venda, remessas).

Configuração

Campo	Obrigatório	Observações
Conexão do Acumatica	Sim	A conexão do Acumatica pela qual ler.
Tabela de destino	Sim	A tabela de projeto na qual os resultados são gravados. Ela é totalmente sobrescrita a cada execução.
Tipo de entidade	Sim	Qual entidade buscar. Padrão: account. Uma entre account, ledger, financial_period, branch, currency, currency_rate, subaccount, customer, vendor, stock_item, warehouse, employee, tax_category, sales_invoice, bill, sales_order, shipment, project.
Somente ativos	Não	Ativado por padrão. Filtra por Active = true nas entidades que têm um indicador Active.
Atualizado após	Não	Data ou data e hora ISO. Somente as linhas alteradas depois disso são retornadas. É um filtro do lado da solicitação, sem cursor persistido — informe você mesmo a data de corte a cada execução. Em branco, busca tudo.
Filters	Não	Uma matriz de cláusulas {field, operator, value} (eq, ne, gt, ge, lt, le, contains) ou intervalos {field, from, to}. Cada entidade restringe os filtros aos campos que o Acumatica realmente consegue avaliar no servidor — um campo sem suporte é rejeitado, e não descartado em silêncio.

Nota

O balancete, o detalhe de transações do razão geral, o estoque disponível, os orçamentos e os dados de intercompanhia ficam em Consultas Genéricas (Generic Inquiries) do Acumatica, e não nestas 18 entidades baseadas em contrato. Crie a consulta genérica no Acumatica e busque-a com uma conexão REST genérica.

Cuidado

A filtragem alcança apenas campos no nível de entidade e de cabeçalho — as dimensões de item de linha de um documento (por exemplo, um centro de custo nas linhas de uma fatura de fornecedor) não podem ser consultadas no servidor. Busque a entidade e delimite o detalhe no nível de linha no seu fluxo de trabalho, depois da importação.

Relacionados

• Etapas do Acumatica
• Conectar ao Acumatica — passo a passo
• Conector REST do Acumatica