# Integrações e API

As integrações importam documentos e recebem eventos de chegada, entrega, coleta, ocorrência e comprovante.

## Proteção contra duplicidade

Uma nova importação deve atualizar somente campos permitidos do movimento existente. Status finalizados não devem ser regredidos pela repetição do mesmo arquivo. Uma ocorrência reprogramada para um novo dia preserva o histórico e pode retornar visualmente para Em rota no novo movimento.

## Documentação da API

Consulte **Documentação API** para autenticação, endpoints, exemplos de importação, edição, exclusão, consultas, tracking, comprovantes, veículos e motoristas.

## Boas práticas

- Use uma chave externa estável para identificar o documento;
- Não altere o identificador a cada reenvio;
- Envie datas no formato documentado;
- Trate respostas HTTP e mensagens de validação;
- Nunca exponha tokens em páginas públicas ou logs.