For TMS, ERP and IT teams

Build the DeCA into your own system

Issue, change, complete and cancel the DeCA from your TMS or ERP with a documented REST API. Free, like everything else.

Create free account Developers

# Issue a DeCA from your 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

The DeCA's whole life

The same endpoints the web app uses, with problem+json errors and stable codes.

Validate before issuing and show the errors on your screen
Idempotency-Key: a retry never duplicates a DeCA
Your trip reference as external_ref

POST/api/v1/decas/validateCheck without issuing
POST/api/v1/decasIssue and get the link
PATCH/api/v1/decas/{id}Change with the same QR
POST/api/v1/decas/{id}/completeComplete the service
POST/api/v1/decas/{id}/cancelCancel (PDF stamped ANULADO)
GET/api/v1/decas/{id}/pdfDownload the PDF

Webhooks

Hear about every change

Get a signed call when a DeCA is issued, changed, completed, cancelled or imported, including those done on the web or WhatsApp.

HMAC-SHA256 signature with a timestamp
Automatic retries and an id so you never process twice
Send a test event from the web app

DeCA-Event-Type: deca.modified
DeCA-Event-Id: 6f1c2a…
DeCA-Signature: t=1791800000,v1=9e2b…

{ "type": "deca.modified",
  "livemode": true,
  "data": { "external_ref": "DECA-2026-00042",
            "version": 2,
            "url": "https://deca.routyn.com/d/Xk3m9q…" } }

Keys

Test without risk

Build with test keys: they create DeCAs stamped PRUEBA and kept apart from real ones.

Owners create and revoke keys in the web app
Optional expiry per key
Swagger and ReDoc to try every endpoint

See the documentation

Do you plan with Routyn?

Routyn, the leading vehicle routing optimization software, already connects to DeCA: your drivers get each DeCA in Routyn Drive with nothing to integrate.

Discover Routyn

Stop paying for every DeCA

Create free account