Pedir acesso à API

Para ligar o seu sistema à API DeCA, contacte o suporte da SERTEC PESAGE e peça o registo da integração.

Dados para o registo

Indique a empresa que utilizará o serviço, o nome da integração e, se pretender restringir o acesso, os IP públicos de saída dos servidores. Inclua todos os endereços utilizados com proxy, NAT ou várias máquinas.

O suporte configura a integração e entrega um token de acesso seguro pelo canal acordado. Cada integração tem a sua credencial. Uma lista de IP vazia permite acesso de qualquer IP. Peça a atualização antes de utilizar um IP de saída que tenha mudado.

Primeiros passos

1. Peça o token e, se necessário, a autorização dos IP ao suporte da SERTEC PESAGE.
2. Guarde o token na configuração segura do servidor.
3. Envie Authorization: Bearer YOUR_API_TOKEN de um IP autorizado se existirem restrições.

Os tokens sk_test_ utilizam desenvolvimento e os sk_live_ produção. Partilham as rotas, com documentos e referências independentes.

O idioma dos documentos da organização determina o idioma dos novos PDF. Alterá-lo não modifica os PDF armazenados. O idioma da documentação, os nomes dos campos JSON e as mensagens de erro da API em inglês são independentes. document_locale regista o idioma utilizado no resultado.

Consulte Credenciais e segurança para configurar a ligação. A Referência da API contém operações, parâmetros e exemplos. Descarregue o contrato como OpenAPI JSON ou OpenAPI YAML.

Conta e arquivo

O código de recuperação pertence à conta do portal e não substitui o token da API. Criar a conta exige configurar uma passkey, imprimir ou descarregar o código e introduzi-lo novamente antes de concluir o registo.

Os PDF são conservados durante um ano e os dados estruturados cifrados durante quatro anos, a partir da emissão ou da data de transporte se posterior. Depois de retirar o PDF, uma pessoa autorizada pode gerar uma cópia privada a partir dos dados conservados. Consulte Credenciais e segurança para os limites de acesso e recuperação.

Experimentar sem registar uma integração

A demonstração pública permite obter um token sk_demo_ temporário e emitir PDF marcados como DEMO com dados fictícios. Expira em 24 horas e não gera documentos válidos para o transporte.