Saltar a contenido

Formato de datos

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