Reopen a transport document
Reopen a manually closed transport document with a reason (3–500 characters). It returns to issued without creating a version. Allowed only before the automatic-close deadline and never after an automatic close; otherwise 422 transport_document_cannot_be_reopened.
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/companies/{company}/transport-documents/{transport_document}/reopen
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Path parameters
Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).
Public identifier (UUID v7) of the transport control document (DeCA).
Headers
Client-generated opaque key (up to 255 characters; UUID v7 recommended) that makes retries safe: the first response is cached and replayed for repeats without re-executing the mutation. Reusing a key with a different body returns 422 idempotency_key_reused; the values of secret fields (password, secret…) count as part of the body, so retrying with a corrected secret under the same key is a different request, never the replay of the earlier answer. See the Idempotency guide.
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Request body
Response
Example response
{
"data": {
"number": "DC-2026-007",
"status": "issued",
"shipper": {
"name": "Transportes Pérez SL",
"tax_id": "B12345674",
"tax_id_country": "ES",
"address": {
"line": "Calle de la Industria 14",
"postal_code": "28901",
"city": "Getafe",
"province": "Madrid",
"country": "ES",
"name": "Nave Getafe"
}
},
"carrier": {
"name": "Transportes Pérez SL",
"tax_id": "B12345674",
"tax_id_country": "ES",
"address": {
"line": "Calle de la Industria 14",
"postal_code": "28901",
"city": "Getafe",
"province": "Madrid",
"country": "ES",
"name": "Nave Getafe"
}
},
"vehicle": {
"tractor_plate": "1234BCD",
"tractor_plate_country": "ES",
"trailer_plate": "R1234BCD",
"trailer_plate_country": "ES"
},
"shipments": [
{
"origin": {
"line": "Calle de la Industria 14",
"postal_code": "28901",
"city": "Getafe",
"province": "Madrid",
"country": "ES",
"name": "Nave Getafe"
},
"destination": {
"line": "Calle de la Industria 14",
"postal_code": "28901",
"city": "Getafe",
"province": "Madrid",
"country": "ES",
"name": "Nave Getafe"
},
"goods": [
{
"description": "Aceite de oliva virgen extra 5 L",
"quantity": "12.0000",
"unit": "garrafa",
"gross_weight_kg": "4.8500"
}
],
"declared_measure": {
"weight_kg": "1250.5000"
},
"source_changes": [
{
"field": "vehicle.tractor_plate",
"previous": "1234BCD",
"current": "5678FGH"
}
]
}
],
"versions": [
{
"number": 2,
"reason": "Avería de la tractora",
"changes": [
{
"field": "vehicle.tractor_plate",
"previous": "1234BCD",
"current": "5678FGH"
}
]
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.