El formato de los datos de tipo:
datetime debe ser ISO 8601, es decir "AAAA-MM-DDThh:mm:ss.sssZ".
date debe ser ISO 8601 solo con la parte de fecha, es decir "AAAA-MM-DD" (sin componente de hora). Este es el formato usado en las fechas de transporte (transportDate).
decimal debe ser con el punto como un único separador decimal válido, por ejemplo 1999.99 o 0.45
guid: Los identificadores son UUID v4 (formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Si no se indican, se asumen por defecto los valores para los tipos de datos:
| Tipo |
Valor |
boolean |
false |
integer |
0 |
decimal |
0 |
string |
|
datetime |
0001-01-01T00:00:00+00:00 |
date |
0001-01-01 |
DeCA
Datos del Documento Electrónico de Control Administrativo por carretera, empleados para:
| Propiedad |
Tipo de dato |
Requerido |
Descripción |
contractualCharger |
ContractualCharger |
Sí |
Cargador contractual (Art. 6.a) |
actualCarrier |
ActualCarrier |
Sí |
Transportista efectivo (Art. 6.b) |
shipments |
List<Shipment> |
Sí |
Transporte (Art. 6.c) y Mercancía (Art. 6.d) |
vehicle |
Vehicle |
Sí |
Vehículo (Art. 6.g) |
transportDate |
date |
Sí |
Fecha de realización del transporte (Art. 6.f) |
specialCirculationPermit |
string |
No |
Autorización especial de circulación, si aplica (Art. 6.e) |
remarks |
string |
No |
Observaciones, reservas o cualquier otra indicación útil (Art 6.h) |
logo |
string |
No |
Logo de empresa a mostrar en el PDF y/o en email de notificación. String base64 con el contenido de archivo PNG/JPG/GIF/BMP |
ContractualCharger
| Propiedad |
Tipo de dato |
Requerido |
Descripción |
businessName |
string |
Sí |
Nombre o denominación social |
taxIdentificationNumber |
string |
Sí |
NIF, NIE o CIF español válido |
address |
string |
Sí |
Domicilio fiscal o social |
ActualCarrier
| Propiedad |
Tipo de dato |
Requerido |
Descripción |
businessName |
string |
Sí |
Nombre o denominación social |
taxIdentificationNumber |
string |
Sí |
NIF, NIE o CIF español válido, o identificador fiscal extranjero (formato tipo VIES: código de país ISO 3166-1 alfa-2 ≠ ES + hasta 12 caracteres alfanuméricos con al menos un dígito). El transportista efectivo puede ser una empresa extranjera realizando transporte nacional |
Shipment
| Propiedad |
Tipo de dato |
Requerido |
Descripción |
origin |
string |
Sí |
Lugar de origen del transporte (Art. 6.c) |
destination |
string |
Sí |
Lugar de destino del transporte (Art. 6.c) |
goodsNature |
string |
Sí |
Naturaleza de la mercancía transportada (Art. 6.d) |
packageCount |
integer |
No |
Número de bultos de la mercancía transportada (Art. 6.d) |
weightKg |
decimal |
Condicional |
Peso en kilogramos (Art. 6.d). Obligatorio si no se indica alternativeMagnitude |
alternativeMagnitude |
string |
Condicional |
Magnitud alternativa cuando el peso no sea determinable (Art. 6.d) |
Vehicle
| Propiedad |
Tipo de dato |
Requerido |
Descripción |
licensePlate |
string |
Condicional |
Matrícula principal del vehículo. Obligatoria salvo que se informen tractorLicensePlate y semitrailerLicensePlate (conjunto articulado completo), en cuyo caso es opcional y no se imprime en el PDF |
tractorLicensePlate |
string |
Condicional |
Matrícula del tractor en conjuntos articulados. Si se indica, debe hacerlo también semitrailerLicensePlate |
semitrailerLicensePlate |
string |
Condicional |
Matrícula del semirremolque o remolque. Si se indica, debe hacerlo también tractorLicensePlate |
vehicleChange |
string |
No |
Descripción del cambio de vehículo durante el transporte, si ocurrió |
Recipient
Datos para notificar el Documento Electrónico de Control Administrativo por carretera, empleados para:
| Propiedad |
Tipo de dato |
Requerido |
Descripción |
channel |
0 = Email, 1 = SMS, 2 = WhatsApp |
Sí |
Tipo de notificación a enviar |
address |
string |
Sí |
Dirección de destino según canal. Si Email, el formato debe ser de email, sino un número de teléfono E.164 (por ejemplo +34666123456) |
name |
string |
No |
Nombre del destinatario |