Especificações para Leitura do Layout XML
Este artigo tem como intuito disponibilizar os layouts de integração em formato XML para os documentos fiscais processados pelo InvoiCy. O objetivo é fornecer aos desenvolvedores a estrutura completa de campos necessária para a comunicação entre o seu ERP e a nossa plataforma, garantindo que os dados sejam transmitidos de forma correta e eficiente.
Abaixo, apresentamos uma tabela de legenda que serve como guia para a interpretação técnica dos layouts. Nela, detalhamos as convenções utilizadas para tipos de campos, ocorrências e hierarquias de elementos, permitindo uma leitura precisa das especificações contidas nos arquivos de download disponíveis.
Para realizar a integração, basta identificar a versão do layout desejada e baixar o respectivo arquivo XLS, que contém o detalhamento técnico de cada campo de envio e retorno. Recomendamos a consulta regular a estas especificações para assegurar que a sua aplicação esteja sempre em conformidade com os padrões de estrutura de dados exigidos pelo sistema.
| COLUNA | NOME DO CAMPO |
|---|---|
| Tipo (tamanho) | N - Campo numérico C- Campo alfanumérico D - Campo data H - Campo hora |
| Ele | G - Grupo E - Elemento CG - Elemento de Grupo que deriva de uma escolha (choice) CE - Elemento que deriva de uma escolha (choice) |
| Pai | TAG Raiz do XML de integração |
| Ocorrência | x-y, onde x indica a ocorrência miníma e y a ocorrência máxima: 1-1 = Campo obrigatório, com uma possibilidade; 1-N = Campo obrigatório, com uma ou várias possibilidades; 0-1 = Campo opcional, com uma possibilidade; 0-N = Campo opcional, com uma ou várias possibilidades; |
O layout do XML para cada um dos módulos/eventos e demais funcionalidades está disponível para download em arquivo XLS. Para acessá-los acesse o repositório do GitHub.