Códigos de error de Documentos de control
Todos los códigos de error de la API pública que emite Documentos de control, con su estado HTTP, su type y una página por código.
Códigos de error que emite Documentos de control. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
delivery_note_cancelled | invalid_request_error | 422 | Uno de los albaranes enviados para prerrellenar el documento de control está anulado, y un albarán anulado no puede ser origen de un envío. No se ha creado nada. |
invalid_cargo_measure | invalid_request_error | 422 | La magnitud declarada de un envío no es válida: su type no es weight ni other, falta el peso o el valor o no es mayor que cero, o la unidad libre no tiene entre 1 y 30 caracteres. |
invalid_transport_tax_id | invalid_request_error | 422 | La identificación fiscal de una parte no es válida: un NIF, NIE o CIF español con el carácter de control erróneo, o un identificador extranjero fuera de 2 a 20 caracteres alfanuméricos. |
invalid_vehicle_plate | invalid_request_error | 422 | Una matrícula no encaja en un formato español (actual, provincial antigua, remolque R, especial E o histórica H; las españolas no llevan vocales) ni en una extranjera de 2 a 12 caracteres alfanuméricos con su país. |
transport_date_in_past | invalid_request_error | 422 | Un documento de control se emite antes de iniciar el transporte, y una de las fechas de transporte es anterior a hoy (Europe/Madrid). El borrador admite cualquier fecha; la emisión no. |
transport_document_cannot_be_cancelled | invalid_request_error | 422 | Solo se puede anular un documento de control emitido y en curso; un borrador se borra, y uno cerrado, anulado o sustituido no se anula. |
transport_document_cannot_be_closed | invalid_request_error | 422 | Solo se puede cerrar un documento de control emitido; este es un borrador o ya está cerrado, anulado o sustituido. |
transport_document_cannot_be_deleted | invalid_request_error | 422 | Solo se puede borrar un borrador: un documento de control emitido se conserva como prueba durante todo su plazo de conservación. |
transport_document_cannot_be_edited | invalid_request_error | 422 | Solo un documento de control en borrador se puede editar; este ya está emitido, cerrado, anulado o sustituido. |
transport_document_cannot_be_modified | invalid_request_error | 422 | Solo se puede modificar un documento de control emitido, y la modificación debe dejarlo con todos los datos obligatorios y al menos un envío. |
transport_document_cannot_be_reopened | invalid_request_error | 422 | Solo se puede reabrir un documento de control cerrado a mano, y solo antes de su plazo de cierre automático; tras un cierre automático queda cerrado. |
transport_document_cannot_be_superseded | invalid_request_error | 422 | Solo se puede marcar como sustituido por el documento del transportista un documento de control emitido y en curso. |
transport_document_file_unavailable | not_found_error | 410 | Los PDF de este documento de control se purgaron al terminar su plazo de conservación (un año tras cerrarlo, anularlo o sustituirlo, y solo porque la cuenta está cerrada). El documento y sus datos se conservan. |
transport_document_no_changes | invalid_request_error | 422 | La modificación trae exactamente los mismos datos que la versión vigente, así que no hay versión nueva que publicar. |
transport_document_not_found | not_found_error | 404 | El identificador no resuelve a ningún documento de control de la empresa autenticada, o el token público no existe. |
transport_document_not_issuable | invalid_request_error | 422 | El documento no se puede emitir: no es un borrador o le faltan datos obligatorios del art. 6 de la Orden FOM/2861/2012 (partes, NIF, domicilio del cargador, envíos con origen, destino, mercancía y magnitud, matrícula de la tractora o fecha de transporte). |
transport_document_not_sendable | invalid_request_error | 422 | No se puede enviar el documento por email: no está emitido ni cerrado, no hay destinatario (sin to y el contacto transportista sin email) o to, cc y bcc suman más de 5 direcciones. |
transport_document_parties_immutable | invalid_request_error | 422 | Tras emitir, el cargador contractual y el transportista efectivo quedan fijados: la norma no permite cambiarlos en una modificación. |
transport_document_pdf_too_large | invalid_request_error | 422 | El PDF de la versión superaría los 5 MB (5.000.000 bytes) que permite la normativa por la cantidad de datos del documento: envíos, líneas de mercancía, descripciones u observaciones. No se ha guardado nada. |
transport_document_version_limit_reached | invalid_request_error | 422 | Un documento de control admite como máximo 50 versiones y la última se reserva para anularlo o sustituirlo, así que ya no admite más modificaciones. No se ha guardado nada. |
transport_document_version_not_found | not_found_error | 404 | El documento de control existe, pero no tiene la versión pedida en version: sus versiones van de la 1 a la vigente (current_version). |
transport_outside_spain | invalid_request_error | 422 | El documento de control solo cubre transporte interior, y un envío sale o llega fuera de España. El transporte internacional se documenta con la carta de porte CMR. |
Relacionado
Códigos de error por categoría
Localiza un error por la categoría que lo emite.
Tabla de referencia completa
Todos los códigos, estados HTTP, tipos y descripciones en una referencia.
Modelo de errores
Interpreta la respuesta de error y gestiona los errores por código.