Impressão de etiquetas com Dynamics 365 Business Central: extensões AL, REST e integração por arquivo
Imprima etiquetas de item, lote, posição e expedição do Business Central (nuvem ou on-premises) com uma extensão AL que chama a API REST, pastas monitoradas ou views SQL — cenários e lista de verificação para armazéns de PMEs.
O Business Central é o ERP de milhares de fabricantes e distribuidores que superaram as planilhas, e sua impressão de etiquetas costuma ser um acréscimo: um layout de relatório enviado a uma impressora do Windows. Quando a empresa acrescenta um segundo armazém, uma impressora térmica de outra marca ou um fluxo de separação móvel, essa abordagem quebra. O EtikStudio se conecta ao BC por vias que não exigem tocar na aplicação base.
Quais vias de integração se encaixam no Business Central
| Via | Encaixe | Por quê |
|---|---|---|
| API REST via extensão AL | Ideal | Uma pequena extensão AL adiciona uma ação 'Imprimir etiqueta' nas páginas de item, lote ou remessa e chama a API REST com HttpClient. Funciona na nuvem e on-premises. |
| Pasta monitorada | Bom | Exportações por fila de trabalhos (CSV/XML) para uma pasta ou FTP; o EtikStudio imprime o lote. Sem desenvolvimento AL. |
| Dados embutidos (SQL / ODBC) | On-premises | Views somente leitura no banco do BC; em tenants na nuvem use as páginas de API ou uma réplica exportada. |
| Conector + relay | Bom | O BC online imprime nas impressoras do armazém pelo conector vinculado — sem VPN nem IP público. |
Cenários típicos
| Processo | Etiqueta | Disparo |
|---|---|---|
| Compras | Etiquetas de item e lote no recebimento | Registro do recebimento de armazém |
| Manufatura | Etiquetas de produto acabado com lote e validade, GS1-128 | Registro do diário de saída |
| Armazém | Etiquetas de posição e de separação | Criação de posição, criação de separação |
| Vendas | Etiquetas de expedição com SSCC e endereço de entrega | Registro da remessa de venda |
Fluxo recomendado
Para a maioria das PMEs, a extensão AL é um dia de trabalho: uma codeunit que monta o JSON a partir do registro e chama o servidor REST, mais uma ação nas páginas relevantes e uma tabela de configuração que mapeia depósitos a impressoras. Empresas sem parceiro começam pela pasta monitorada e adicionam a extensão depois.
Lista de verificação de implantação
- Decidir nuvem ou on-premises: tenants na nuvem alcançam o servidor REST pelo conector; on-premises pode chamá-lo diretamente na LAN.
- Criar uma tabela de configuração: código do depósito → nome da impressora → modelo padrão.
- Incluir lote e validade na chamada para etiquetas GS1-128 e GS1 DataMatrix; o EtikStudio formata os AIs.
- Testar com as descrições de item mais longas para evitar transbordos.
- Manter a extensão AL mínima: dados para fora, id de trabalho de volta; o design fica no EtikStudio.
Como o EtikStudio resolve
O design, a linguagem da impressora e as mudanças de frota ficam fora do AL. O Business Central envia o registro; o EtikStudio renderiza, imprime na impressora certa no depósito certo e mantém o histórico de impressão que o auditor pede.
Os detalhes de integração variam conforme versão, implantação e licenciamento do ERP. Adaptadores e exemplos são fornecidos durante a implementação.