A API do DeCA, gratuita e documentada

# 1. Check it without issuing anything
curl -X POST https://api.deca.routyn.com/api/v1/decas/validate \
  -H "Authorization: Bearer $DECA_API_KEY" \
  -H "Content-Type: application/json" \
  -d @deca.json

# 2. Issue it (a retry with the same external_ref returns the same DeCA)
curl -X POST https://api.deca.routyn.com/api/v1/decas \
  -H "Authorization: Bearer $DECA_API_KEY" \
  -H "Content-Type: application/json" \
  -d @deca.json

# deca.json
{
  "external_ref": "TRIP-2026-1012-A",
  "data": {
    "shipper_name": "Logística Ibérica S.L.",
    "shipper_tax_id": "B12345678",
    "shipper_address": "Calle Mayor 10, 28013 Madrid",
    "carrier_name": "Transportes Ejemplo S.A.",
    "carrier_tax_id": "A87654321",
    "vehicle_plate": "1234 KLM",
    "transport_date": "2026-10-12",
    "lines": [
      {
        "origin": "Polígono Industrial Las Mercedes, 28022 Madrid",
        "destination": "Puerto de Valencia, 46024 Valencia",
        "goods": "Palés de bebidas",
        "weight_kg": 12400
      }
    ]
  }
}

import os, requests

API = "https://api.deca.routyn.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['DECA_API_KEY']}"}
body = {
    "external_ref": "TRIP-2026-1012-A",
    "data": {
        "shipper_name": "Logística Ibérica S.L.",
        "shipper_tax_id": "B12345678",
        "shipper_address": "Calle Mayor 10, 28013 Madrid",
        "carrier_name": "Transportes Ejemplo S.A.",
        "carrier_tax_id": "A87654321",
        "vehicle_plate": "1234 KLM",
        "transport_date": "2026-10-12",
        "lines": [
            {
                "origin": "Polígono Industrial Las Mercedes, 28022 Madrid",
                "destination": "Puerto de Valencia, 46024 Valencia",
                "goods": "Palés de bebidas",
                "weight_kg": 12400
            }
        ]
    }
}

check = requests.post(f"{API}/decas/validate", headers=HEADERS, json=body, timeout=30)
if not check.ok:
    problem = check.json()  # application/problem+json
    raise RuntimeError(f"{problem['code']}: {problem['detail']}")

resp = requests.post(f"{API}/decas", headers=HEADERS, json=body, timeout=30)
resp.raise_for_status()
deca = resp.json()
print(deca["id"], deca["url"])  # url = the QR link

const API = "https://api.deca.routyn.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.DECA_API_KEY}`,
  "Content-Type": "application/json",
};
const body = JSON.stringify({
  "external_ref": "TRIP-2026-1012-A",
  "data": {
    "shipper_name": "Logística Ibérica S.L.",
    "shipper_tax_id": "B12345678",
    "shipper_address": "Calle Mayor 10, 28013 Madrid",
    "carrier_name": "Transportes Ejemplo S.A.",
    "carrier_tax_id": "A87654321",
    "vehicle_plate": "1234 KLM",
    "transport_date": "2026-10-12",
    "lines": [
      {
        "origin": "Polígono Industrial Las Mercedes, 28022 Madrid",
        "destination": "Puerto de Valencia, 46024 Valencia",
        "goods": "Palés de bebidas",
        "weight_kg": 12400
      }
    ]
  }
});

const check = await fetch(`${API}/decas/validate`, { method: "POST", headers, body });
if (!check.ok) {
  const problem = await check.json(); // application/problem+json
  throw new Error(`${problem.code}: ${problem.detail}`);
}
const res = await fetch(`${API}/decas`, { method: "POST", headers, body });
const deca = await res.json();
console.log(deca.id, deca.url); // url = the QR link