Factuarea APIDevelopers
Suport
Ves a l'app
Afegit

Document de control (DeCA) i pes de transport

Nou recurs transport_documents amb 17 endpoints per emetre, modificar, compartir i conservar el document de control digital del transport de mercaderies per carretera, obligatori des del 5 d'octubre de 2026; 15 tools MCP, 10 esdeveniments transport_document.*, 24 codis d'error i pes brut de transport en productes, variants, presentacions i albarans.

Des del 5 d'octubre de 2026 el document de control administratiu del transport públic de mercaderies per carretera ha de ser digital. L'API pública ja l'emet: un PDF per versió, servit des d'una URL pública permanent el codi QR de la qual viatja amb el conductor, amb l'historial que necessita la inspecció. Tot és additiu; cap camp existent no canvia de significat. Consulta la guia del document de control.

Nou recurs transport_documents

OperacióEndpoint
Llistar, amb cursor i els filtres status, transport_date[gte|lte], company_role, carrier_tax_id, delivery_note_id i qGET /v1/transport_documents
Catàleg d'estatsGET /v1/transport_documents/statuses
ObtenirGET /v1/transport_documents/{id}
Crear un esborrany, opcionalment emplenat des d'1 a 50 albaransPOST /v1/transport_documents
Actualitzar o esborrar un esborranyPUT / DELETE /v1/transport_documents/{id}
Emetre (irreversible)POST /v1/transport_documents/{id}/issue
Modificar durant el servei, amb la mateixa URL i el mateix QR (irreversible)POST /v1/transport_documents/{id}/modify
Tancar i reobrirPOST /v1/transport_documents/{id}/close, /reopen
Anul·lar o marcar com a substituït pel document del transportista (irreversible)POST /v1/transport_documents/{id}/cancel, /supersede
Enviar la còpia per email al transportista (irreversible)POST /v1/transport_documents/{id}/send
PDF d'una versió, codi QR i registre d'emissió (cada entrada amb el seu actor_name, els tancaments automàtics com a auto_closed i les 100 primeres descàrregues públiques, amb meta.downloads_total i meta.downloads_listed)GET /v1/transport_documents/{id}/pdf, /qr, /evidence
Justificant d'emissió en PDFGET /v1/transport_documents/{id}/issuance_proof

Scopes nous: transport_documents:read, transport_documents:write, transport_documents:delete i transport_documents:transition, també concedibles per OAuth. El PDF de cada versió exigeix pdfs:read; el justificant d'emissió, transport_documents:read, perquè conté el registre d'emissió. El mòdul transport_documents requereix delivery_notes.

MCP, esdeveniments i errors

  • 15 tools MCP, una per operació llevat del codi QR i el justificant d'emissió, que continuen sent descàrregues binàries de la REST API. search_transport_documents admet el mateix q i el mateix sort que el llistat REST, i create_transport_document no admet id. Consulta el catàleg de tools.
  • 10 esdeveniments: transport_document.created, .updated, .issued, .modified, .closed (amb close_mode manual o automàtic), .reopened, .cancelled, .superseded, .email_sent i .email_failed. Mentre un document és un esborrany, les seves parts segueixen els canvis del contacte enllaçat i de les dades de la teva empresa, i cada refresc que canvia alguna cosa publica .updated. Consulta Esdeveniments.
  • 24 codis d'error: els 22 de la nova categoria «Transport Documents», des de transport_document_not_issuable (amb error.details.missing) fins a transport_document_version_limit_reached, transport_document_pdf_too_large i transport_document_version_not_found (404 davant d'un ?version=N que el PDF no té), més invalid_gross_weight (també a les línies de mercaderia d'un document) i gross_weight_not_allowed a Productes. Consulta el catàleg d'errors.

Límits i identificadors

  • Un document té com a màxim 50 versions, i l'última es reserva per anul·lar-lo o substituir-lo; quan ja en té 49, modify retorna 422 transport_document_version_limit_reached.
  • Cada versió és un PDF de fins a 5 MB (5.000.000 bytes). Emetre, modificar, anul·lar i substituir retornen 422 transport_document_pdf_too_large sense desar res quan el PDF seria més gran.
  • L'id d'un document el genera el servidor. shipments[].id és opcional: en crear, un que ja està en ús retorna 422 a shipments.N.id; en actualitzar i modificar, només identifica un enviament d'aquest document. Una escriptura simultània que xoca en un identificador retorna 409 resource_conflict i es pot reintentar. Els UUID es normalitzen a minúscules.
  • En crear, un enviament que omet origin pren el teu lloc de càrrega per defecte o el teu domicili fiscal; un "origin": null explícit el deixa sense origen.
  • La URL pública es limita per token i prefix de xarxa (60 per minut per defecte) i per token (600 per minut per defecte), mai només per IP; els tokens desconeguts compten per prefix de xarxa. El PDF públic no mostra qui va fer cada versió.

Pes brut de transport al catàleg i als albarans

  • Els productes, les variants i les presentacions fixes accepten gross_weight_kg en crear i actualitzar, i el publiquen en llegir: kg per unitat base en productes i variants i per unitat comercial en presentacions. Ometre'l en actualitzar conserva el valor actual i null l'esborra. Els serveis, les unitats base de massa (KGM, GRM) i les presentacions variable_measure el rebutgen amb gross_weight_not_allowed.
  • Les línies d'albarà congelen el seu pes en crear-se o editar-se en esborrany i el publiquen com a gross_weight_kg; l'albarà afegeix total_gross_weight_kg i lines_without_weight_count.
  • Les sèries accepten el nou tipus transport_document (codi per defecte DC), la sèrie del qual es crea en la primera emissió. GET /v1/series/stats el compta.

Nous endpoints17

EndpointDescripció
GET/v1/transport_documentsLlistar tots els documents de control
GET/v1/transport_documents/statusesLlistar els estats del document de control
GET/v1/transport_documents/{transport_document}Obtenir un document de control
POST/v1/transport_documentsCrear un document de control
PUT/v1/transport_documents/{transport_document}Actualitzar un document de control en esborrany
DEL/v1/transport_documents/{transport_document}Esborrar un document de control en esborrany
POST/v1/transport_documents/{transport_document}/issueEmetre un document de control
POST/v1/transport_documents/{transport_document}/modifyModificar un document de control emès
POST/v1/transport_documents/{transport_document}/closeTancar un document de control
POST/v1/transport_documents/{transport_document}/reopenReobrir un document de control
POST/v1/transport_documents/{transport_document}/cancelAnul·lar un document de control
POST/v1/transport_documents/{transport_document}/supersedeMarcar un document de control com a substituït
POST/v1/transport_documents/{transport_document}/sendEnviar un document de control per email
GET/v1/transport_documents/{transport_document}/pdfDescarregar el PDF d'un document de control
GET/v1/transport_documents/{transport_document}/qrDescarregar el codi QR d'un document de control
GET/v1/transport_documents/{transport_document}/evidenceLlistar el registre d'emissió d'un document de control
GET/v1/transport_documents/{transport_document}/issuance_proofDescarregar el justificant d'emissió d'un document de control

Endpoints actualitzats21

EndpointDescripció
POST/v1/productsCrear un producte
PUT/v1/products/{product}Actualitzar un producte
GET/v1/products/{product}Obtenir un producte
GET/v1/productsLlistar tots els productes
POST/v1/products/{product}/variantsCrear una variant de producte
PUT/v1/products/{product}/variants/{variant}Actualitzar una variant de producte
GET/v1/products/{product}/variantsLlistar variants de producte
POST/v1/products/{product}/presentationsCrear una presentació de producte
PUT/v1/products/{product}/presentations/{presentation}Actualitzar una presentació de producte
GET/v1/products/{product}/presentationsLlistar presentacions de producte
POST/v1/delivery_notesCrear un albarà
PUT/v1/delivery_notes/{delivery_note}Actualitzar un albarà
GET/v1/delivery_notes/{delivery_note}Obtenir un albarà
GET/v1/delivery_notesLlistar tots els albarans
POST/v1/seriesCrea una sèrie
GET/v1/seriesLlistar totes les sèries
GET/v1/series/statsObtenir estadístiques de sèries
POST/v1/webhook_endpointsCrea un webhook endpoint
PUT/v1/webhook_endpoints/{webhook_endpoint}Actualitzar un webhook endpoint
GET/v1/eventsLlistar tots els esdeveniments
POST/v1/account/api-keysCrear una API key
Anterior

Totes les novetats

Versions, canvis de contracte i novetats de les eines per a la teva integració.

Següent

Devolucions dels cobraments no facturats

Els cobraments de Stripe que no es facturen porten les seves devolucions i l'import net que es queda el comerç, es poden filtrar per data i arriben a la gestoria en l'enviament trimestral com a CSV. Quatre operacions actualitzades i tres tools MCP actualitzades.

En aquesta pàgina

Nou recurs transport_documentsMCP, esdeveniments i errorsLímits i identificadorsPes brut de transport al catàleg i als albarans
Et donem un cop de mà?Contactar amb suport