Orientação

1. Entenda o fluxo da integração

O sistema parceiro envia uma solicitação para a API Nota Box informando a empresa, o período desejado e o endereço que receberá os arquivos.

A solicitação entra em uma fila de processamento e é tratada individualmente por CNPJ.

Quando o processamento termina, o Tron Box envia os arquivos automaticamente para o webhook informado pelo sistema parceiro.

Não é necessário realizar o download manual dos XMLs no portal.

2. Confira como os documentos são entregues

A entrega é realizada por meio de uma requisição POST, utilizando multipart/form-data.

O sistema parceiro recebe:

• file: arquivo ZIP contendo os XMLs;
• metadata: informações sobre o lote, como empresa, quantidade de XMLs e data do envio.

O webhook informado para recebimento deve utilizar HTTPS e permanecer disponível para receber os arquivos.

3. Considere os limites de processamento

Conforme as regras da integração:

• o período máximo informado em cada solicitação é de 30 dias;
• o processamento é realizado separadamente por CNPJ;
• cada lote pode conter até 1.000 XMLs;
• quando houver mais documentos, poderão ser enviados vários arquivos ZIP;
• o limite de transferência por lote é de até 50 MB;
• é permitida 1 requisição a cada 5 minutos por CNPJ;
• o tempo limite de resposta do webhook é de até 120 segundos;
• em caso de falha no recebimento, podem ocorrer até 3 tentativas automáticas.

O sistema parceiro deve estar preparado para receber mais de um lote para a mesma solicitação ou período.

Importante

O sistema que receberá os documentos deve manter o webhook disponível e tratar possíveis reenvios sem gerar duplicidade de XMLs.

Respostas 200 OK ou 204 No Content indicam que o recebimento foi concluído corretamente. Após as tentativas automáticas previstas, situações não processadas podem exigir reprocessamento.