Saltar para o conteúdo
DeCAby Routyn
PT

Para TMS, ERP e equipas de sistemas

Integre o DeCA no seu próprio sistema

Emita, modifique, conclua e anule o DeCA a partir do seu TMS ou ERP com uma API REST documentada. Gratuito, como tudo o resto.

Criar conta grátisProgramadores
# Emitir um DeCA a partir do seu TMS
curl https://api.deca.routyn.com/api/v1/decas \
  -H "Authorization: Bearer $DECA_KEY" \
  -H "Idempotency-Key: viaje-1012" \
  -d '{"carrier_id": "…", "shipper_id": "…",
       "vehicle_id": "…", "transport_date": "2026-10-12",
       "lines": [{"origin": "Coslada", "destination": "Valencia",
       "goods": "Bebidas", "weight_kg": 12400}]}'

201 Created
{ "external_ref": "DECA-2026-00042",
  "status": "issued", "version": 1,
  "url": "https://deca.routyn.com/d/Xk3m9q…" }

Endpoints

Todo o ciclo do DeCA

Os mesmos endpoints que a web usa, com erros problem+json e códigos estáveis.

  • Valide antes de emitir e mostre os erros no seu ecrã
  • Idempotency-Key: uma nova tentativa nunca duplica um DeCA
  • A sua referência de viagem como external_ref
  • POST/api/v1/decas/validateVerifica sem emitir
  • POST/api/v1/decasEmite e devolve o link
  • PATCH/api/v1/decas/{id}Modifica com o mesmo QR
  • POST/api/v1/decas/{id}/completeConclui o serviço
  • POST/api/v1/decas/{id}/cancelAnula (PDF ANULADO)
  • GET/api/v1/decas/{id}/pdfDescarrega o PDF

Webhooks

Saiba de cada alteração

Receba um aviso assinado quando um DeCA é emitido, modificado, concluído, anulado ou importado, incluindo os que são feitos na web ou no WhatsApp.

  • Assinatura HMAC-SHA256 com carimbo temporal
  • Novas tentativas automáticas e um identificador para não processar duas vezes
  • Envie um evento de teste a partir da web

Chaves

Teste sem risco

Desenvolva com chaves de teste: geram DeCA com a marca PRUEBA e são guardados separadamente dos reais.

  • Os proprietários criam e revogam chaves na web
  • Prazo de validade opcional por chave
  • Swagger e ReDoc para testar cada endpoint
Ver a documentação

Usa o Routyn para planear?

O Routyn, o software líder de otimização de rotas de veículos, já está ligado ao DeCA: os seus motoristas recebem cada DeCA no Routyn Drive sem integrar nada.

Conhecer o Routyn

Deixe de pagar por cada DeCA

Registe-se hoje e emita o seu primeiro documento em poucos minutos. Grátis, com a sua equipa e com API.

Criar conta grátis