Documentación de la API

Autenticación

Un sistema de despacho presenta su clave en x-api-key. La clave pertenece a un cliente y sólo puede actuar sobre él: el inquilino nunca viaja en el cuerpo ni en la URL, porque ambos los escribe quien llama.

Una persona presenta un token de su propio directorio en Authorization: Bearer. Lo que puede hacer lo decide el rol que su administrador le asignó, nunca una reivindicación del token.

Seguridad y límites

Sólo HTTPS, con TLS 1.2 o superior. Toda petición pasa antes por un cortafuegos de aplicaciones web con el conjunto de reglas OWASP y protección contra bots, que rechaza más de 600 peticiones por minuto desde una misma dirección.

Cada clave tiene su propio límite por minuto, según la edición contratada: de 60 a 420 peticiones. Al superarlo la respuesta es 429, con Retry-After y las cabeceras RateLimit-* diciendo cuándo volver a intentarlo.

Una clave por sistema de despacho, guárdala como un secreto y revócala desde la plataforma en cuanto deje de usarse. Se muestra una sola vez y nosotros sólo guardamos su huella.

Para comunicar una vulnerabilidad, sigue nuestra política de divulgación.

Emitir un documento

La llamada que integra el 90 % de los casos. Devuelve el identificador, la URL pública y la huella del PDF publicado.

curl -X POST https://api.deca2u.com/v1/documents \
  -H "x-api-key: $DECA2U_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "siteId": "V204",
    "externalRef": "V204-40712",
    "data": {
      "contractualShipper": {
        "name": "Conservas Bahía Norte, S.L.",
        "taxId": "B36742180",
        "address": "Rúa do Porto 22, 36202 Vigo"
      },
      "effectiveCarrier": { "name": "Transportes Vega Hermanos, S.L.", "taxId": "B99001122" },
      "location": { "origin": "Centro logístico de Vigo", "destination": "Plataforma de Getafe" },
      "goods": { "description": "Conserva vegetal en lata", "quantity": 12400, "unit": "kg" },
      "transportDate": "2026-07-15",
      "vehicle": { "tractorPlate": "1234ABC", "articulated": false }
    }
  }'

const response = await fetch('https://api.deca2u.com/v1/documents', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.DECA2U_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    siteId: 'V204',
    externalRef: 'V204-40712',
    data: {
      contractualShipper: {
        name: 'Conservas Bahía Norte, S.L.',
        taxId: 'B36742180',
        address: 'Rúa do Porto 22, 36202 Vigo',
      },
      effectiveCarrier: { name: 'Transportes Vega Hermanos, S.L.', taxId: 'B99001122' },
      location: { origin: 'Centro logístico de Vigo', destination: 'Plataforma de Getafe' },
      goods: { description: 'Conserva vegetal en lata', quantity: 12400, unit: 'kg' },
      transportDate: '2026-07-15',
      vehicle: { tractorPlate: '1234ABC', articulated: false },
    },
  }),
});

if (!response.ok) throw new Error(`DeCA2U answered ${response.status}`);
const { id, url } = await response.json();

import os
import requests

response = requests.post(
    "https://api.deca2u.com/v1/documents",
    headers={"x-api-key": os.environ["DECA2U_KEY"]},
    json={
        "siteId": "V204",
        "externalRef": "V204-40712",
        "data": {
            "contractualShipper": {
                "name": "Conservas Bahía Norte, S.L.",
                "taxId": "B36742180",
                "address": "Rúa do Porto 22, 36202 Vigo",
            },
            "effectiveCarrier": {"name": "Transportes Vega Hermanos, S.L.", "taxId": "B99001122"},
            "location": {"origin": "Centro logístico de Vigo", "destination": "Plataforma de Getafe"},
            "goods": {"description": "Conserva vegetal en lata", "quantity": 12400, "unit": "kg"},
            "transportDate": "2026-07-15",
            "vehicle": {"tractorPlate": "1234ABC", "articulated": False},
        },
    },
    timeout=10,
)
response.raise_for_status()
issued = response.json()

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://api.deca2u.com/") };
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("DECA2U_KEY"));

var response = await http.PostAsJsonAsync("v1/documents", new
{
    siteId = "V204",
    externalRef = "V204-40712",
    data = new
    {
        contractualShipper = new
        {
            name = "Conservas Bahía Norte, S.L.",
            taxId = "B36742180",
            address = "Rúa do Porto 22, 36202 Vigo",
        },
        effectiveCarrier = new { name = "Transportes Vega Hermanos, S.L.", taxId = "B99001122" },
        location = new { origin = "Centro logístico de Vigo", destination = "Plataforma de Getafe" },
        goods = new { description = "Conserva vegetal en lata", quantity = 12400, unit = "kg" },
        transportDate = "2026-07-15",
        vehicle = new { tractorPlate = "1234ABC", articulated = false },
    },
});

response.EnsureSuccessStatusCode();
var issued = await response.Content.ReadFromJsonAsync<Issued>();

var body = """
  {
    "siteId": "V204",
    "externalRef": "V204-40712",
    "data": {
      "contractualShipper": {
        "name": "Conservas Bahía Norte, S.L.",
        "taxId": "B36742180",
        "address": "Rúa do Porto 22, 36202 Vigo"
      },
      "effectiveCarrier": { "name": "Transportes Vega Hermanos, S.L.", "taxId": "B99001122" },
      "location": { "origin": "Centro logístico de Vigo", "destination": "Plataforma de Getafe" },
      "goods": { "description": "Conserva vegetal en lata", "quantity": 12400, "unit": "kg" },
      "transportDate": "2026-07-15",
      "vehicle": { "tractorPlate": "1234ABC", "articulated": false }
    }
  }
  """;

var request = HttpRequest.newBuilder(URI.create("https://api.deca2u.com/v1/documents"))
    .header("x-api-key", System.getenv("DECA2U_KEY"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

var response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

<?php

$payload = [
    'siteId' => 'V204',
    'externalRef' => 'V204-40712',
    'data' => [
        'contractualShipper' => [
            'name' => 'Conservas Bahía Norte, S.L.',
            'taxId' => 'B36742180',
            'address' => 'Rúa do Porto 22, 36202 Vigo',
        ],
        'effectiveCarrier' => ['name' => 'Transportes Vega Hermanos, S.L.', 'taxId' => 'B99001122'],
        'location' => ['origin' => 'Centro logístico de Vigo', 'destination' => 'Plataforma de Getafe'],
        'goods' => ['description' => 'Conserva vegetal en lata', 'quantity' => 12400, 'unit' => 'kg'],
        'transportDate' => '2026-07-15',
        'vehicle' => ['tractorPlate' => '1234ABC', 'articulated' => false],
    ],
];

$curl = curl_init('https://api.deca2u.com/v1/documents');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('DECA2U_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$issued = json_decode(curl_exec($curl), true);

Respuesta 201:

{
  "id": "8h86UiouAH2eZwOrS4di1Q",
  "url": "https://doc.deca2u.com/yQRjIVKxGsA4SqJoZDn_hw/8h86UiouAH2eZwOrS4di1Q.pdf",
  "publishedAt": "2026-07-15T06:31:02.144Z",
  "publicUntil": "2026-07-22T23:59:59.000Z",
  "pdfHash": "9f2c…",
  "qr": "<svg xmlns=…>",          // only with ?qr=1
  "externalRef": "V204-40712"
}

Si la expedición ya tenía documento responde 200 con alreadyIssuedAs y la URL existente, en vez de emitir un segundo. Si falta alguna letra obligatoria responde 422 y enumera cuáles: un documento incompleto no es un DeCA y no se publica.

El resto - corregir, reemitir, los catálogos del cliente, los bloques de identificadores para un sitio sin línea - está documentado ruta por ruta dentro de la plataforma, en Administración, para quien ya tiene una cuenta.

La API que usa nuestra propia aplicación.

Autenticación

Seguridad y límites

Emitir un documento