Evento por actualizacion de datos: Datos del Transporte
Mediante este evento podrá informar a la Entidad Tributaria cambios o actualizaciones con relación al chofer, al transportista, al vehículo, al local de entrega y otros datos del transporte. Los parámetros para mandar en la API son los siguientes:
| Actualización de datos: Datos del Transporte (request) | |||||
|---|---|---|---|---|---|
| Parámetro | Tipo de parámetro | Tipo de dato | Descripción | Valores permitidos | Longitud |
| CountryDocumentId* | String | Alfanumérico | Identificador fiscal del documento a nivel país | 44 caracteres | |
| status* | Integer | Numérico | Código del evento | 35 | 2 caracteres |
| description* | String | Alfanumérico | Descripción del motivo del evento | 5 - 500 caracteres | |
| code* | Integer | Numérico | Código del metivo del evento | 1= Cambio del local de la entrega 2= Cambio del chofer 3= Cambio del transportista 4= Cambio de vehículo | 1 caracter |
| receiverDepartmentCode | Integer | Numérico | Código del departamento del local de la entrega | Definidos en el catalogo de departamentos | 2 caracteres |
| receiverDepartmentName | String | Alfanumérico | Descripción del departamento del local de la entrega | Definidos en el catalogo de departamentos | 6 - 16 caracteres |
| receiverDistrictCode | Integer | Numérico | Código del distrito del local de la entrega | Definidos en el catalogo de distritos | 4 caracteres |
| receiverDistrictName | String | Alfanumérico | Descripción de distrito del local de la entrega | Definidos en el catalogo de distritos | 1 - 30 caracteres |
| receiverCityCode | Integer | Numérico | Código de la ciudad del local de la entrega | Definidos en el catalogo de ciudades | 5 caracteres |
| receiverCityName | String | Alfanumérico | Descripción de ciudad del local de la entrega | Definidos en el catalogo de ciudades | 1 - 30 caracteres |
| receiverAddress | String | Alfanumérico | Dirección del local de la entrega | 1 - 255 caracteres | |
| receiverHouseNumber | Integer | Numérico | Número de casa del local de la entrega | 1 - 6 caracteres | |
| receiverAddressReference | String | Alfanumérico | Complemento de dirección del local de la entrega | 1 - 255 caracteres | |
| driverName* | String | Alfanumérico | Nombre y apellido del chofer | 4 - 60 caracteres | |
| driverCode | String | Alfanumérico | Número de documento de identidad del chofer | 1 - 20 caracteres | |
| carrierTypeTaxpayer | Integer | Numérico | Naturaleza del transportista | 1= Contribuyente 2= No contribuyente | 1 caracter |
| carrierCode | String | Alfanumérico | RUC del transportista / Número de documento de identidad del transportista | 3 - 8 / 1 - 20 caracteres | |
| carrierCodeDV | Integer | Numérico | Dígito verificador del RUC del transportista | 1 caracter | |
| carrierName | String | Alfanumérico | Nombre o razón social del transportista | 4 - 60 caracteres | |
| carrierDocumentType | Integer | Numérico | Tipo de documento de identidad del transportista | 1= Cédula paraguaya 2= Pasaporte 3= Cédula extranjera 4= Carnet de residencia | 1 caracter |
| carriageType | Integer | Numérico | Tipo de transporte | 1= Propio 2= Tercero | 1 caracter |
| carriageMode* | Integer | Numérico | Modalidad del transporte | 1=Terrestre 2= Fluvial 3= Aéreo 4= Multimodal | 1 caracter |
| vehicleType | String | Alfanumérico | Tipo de vehículo | 4 - 10 caracteres | |
| vehicleBrand | String | Alfanumérico | Marca del vehículo | 1 - 10 caracteres | |
| vehicleDocumentType | Integer | Numérico | Tipo de identificación del vehículo | 1=Número de identificación del vehículo 2=Número de matrícula del vehículo | 1 caracter |
| vehicleCode | String | Alfanumérico | Número de identificación del vehículo | 1 - 20 caracteres | |
| vehicleRegistration | String | Alfanumérico | Número de matrícula del vehículo | 6 caracteres |
Ejemplo de petición
Para este método utilizamos la pestaña body en su sección raw de Postman.
- Seleccione el tipo de método. En este caso, se debe seleccionar POST.
- Ingrese la URL del método.
- Ingrese los parámetros que se muestran en la tabla anterior con sus valores correspondientes.
- Presione Send.
{
"CountryDocumentId":"01801288223001002000021222025091011125456905",
"Status": "35",
"description":"Cambio del local de la entrega",
"code":"3",
"receiverDepartmentCode": "17",
"receiverDepartmentName": "Alto Paraguay",
"receiverDistrictCode": "195",
"receiverDistrictName": "Fuerte Olimpo",
"receiverCityCode": "4624",
"receiverCityName": "Fuerte Olimpo",
"receiverAddress": "Yacyretá, Fuerte Olimpo 170101, Paraguay",
"receiverHouseNumber": "170101",
"receiverAddressReference": "Edificio Pepito",
"driverName": "Pedro Perez",
"driverCode": "1236547896",
"carrierTypeTaxpayer": "2",
"carrierCode":"12365478",
"carrierCodeDV":"0",
"carrierName":"Pedro Perez",
"carrierDocumentType":"1",
"carriageType":"1",
"carriageMode":"1",
"vehicleType":"",
"vehicleBrand":"",
"vehicleDocumentType":"1",
"vehicleCode":"3215698",
"vehicleRegistration":""
}Envío a la Entidad Tributaria
Si el evento fue generado satisfactoriamente, se envía a la Entidad Tributaria para su validación y aceptación.
Respuesta de Actualización de datos del transporte
La API responderá a su petición con alguno de los siguientes códigos:
| Códigos de respuesta de Actualización de datos del transporte | ||
|---|---|---|
| Mensaje | Código | Observación |
| Evento registrado correctamente, Evento por actualización de datos: Datos del transporte" | 0600 | Cuando el evento se genero correctamente. |
| El Departamento, el Distrito y la Ciudad del local de entrega no están relacionados | 4300 | Debe haber relación entre el departamento (GET004), el distrito (GET006) y la ciudad (GET008) |
| Código del departamento del local de la entrega requerido para el motivo Cambio del local de la entrega | 4301 | Cuando el motivo del evento es Cambio del local de la entrega (GET003=1), es obligatorio informar el código del departamento del local de la entrega (GET004) |
| Descripción del departamento del local de la entrega es requerida | 4302 | Cuando se informa el código del departamento del local de la entrega (GET004), es obligatorio informar la descripción del departamento del local de la entrega (GET005) |
| Descripción del departamento del local de la entrega no corresponde al código | 4303 | Descripción del departamento del local de la entrega no coincidente con lo informado en el campo GET004 |
| Descripción del distrito del local de la entrega es requerida | 4304 | Cuando se informa el código del distrito del local de la entrega (GET006), es obligatorio informar la descripción del distrito del local de la entrega (GET007) |
| Descripción del distrito del local de la entrega no corresponde al código | 4305 | Descripción del distrito del local de entrega no coincidente con lo informado en el campo GET006 |
| Código de la ciudad del local de la entrega requerido para el motivo Cambio del local de la entrega | 4306 | Cuando el motivo del evento es Cambio del local de la entrega (GET003=1), es obligatorio informar el código de la ciudad del local de la entrega (GET004) |
| Descripción de la ciudad del local de la entrega es requerida | 4307 | Cuando se informa el código de la ciudad del local de la entrega (GET008), es obligatorio informar la descripción de la ciudad del local de la entrega (GET009) |
| Descripción de la ciudad del local de la entrega no corresponde al código | 4308 | Descripción de la ciudad del local de la entrega no coincidente con lo informado en el campo GET008 |
| Dirección del local de la entrega requerida para el motivo Cambio del local de la entrega | 4309 | Cuando el motivo del evento es Cambio del local de la entrega (GET003=1), es obligatorio informar la dirección del local de la entrega (GET010) |
| Número de casa del local de la entrega requerido para el motivo Cambio del local de la entrega | 4310 | Cuando el motivo del evento es Cambio del local de la entrega (GET003=1), es obligatorio informar el número de casa del local de la entrega (GET011) |
| Nombre y apellido del chofer requerido para el motivo Cambio del chofer | 4311 | Cuando el motivo del evento es Cambio del chofer (GET003=2), es obligatorio informar el nombre y apellido del chofer (GET013) |
| Número de documento de identidad del chofer requerido para el motivo Cambio del chofer | 4312 | Cuando el motivo del evento es Cambio del chofer (GET003=2), es obligatorio informar el número de documento de identidad del chofer (GET014) |
| Naturaleza del transportista requerida para el motivo Cambio del transportista | 4313 | Cuando el motivo del evento es Cambio del transportista (GET003=3), es obligatorio informar la naturaleza del transportista (GET015) |
| RUC del transportista no informado | 4314 | Se requiere informar el número de RUC si la naturaleza del transportista es igual a contribuyente (GET015 = 1) |
| RUC del transportista inexistente | 4315 | El RUC del transportista informado no existe en la base de datos de Marangatu |
| El RUC del transportista se encuentra inactivo | 4316 | El RUC del transportista debe contar con un estado distinto a CANCELADO, CANCELADO DEFINITIVO o SUSPENSIÓN TEMPORAL en Marangatu al momento de la emisión del DE |
| RUC del transportista no requerido | 4317 | Si la naturaleza del transportista es distinta a contribuyente (GET015 ≠ 1) el RUC del transportista (GET016) no debe ser informado |
| Dígito Verificador del RUC del transportista incorrecto | 4318 | El Dígito Verificador ingresado (GET017) no corresponde al módulo 11 del RUC (GET016) |
| Nombre o razón social del transportista es requerido para el motivo del evento | 4319 | Cuando el motivo del evento es cambio del transportista (GET003=3), es obligatorio informar el nombre o razón social del transportista (GET018) |
| Tipo de documento de identidad del transportista no informado | 4320 | Se requiere informar el tipo de documento de identidad si la naturaleza del transportista es igual a NO contribuyente (GET015 =2) |
| Tipo de documento de identidad del transportista no requerido | 4321 | Si la naturaleza del transportista es igual a contribuyente (GET015 =1) el tipo de documento de identidad del transportista (GET019) no debe ser informado |
| Descripción del tipo de documento de identidad del transportista no informada | 4322 | Si se informa el código de tipo de documento de identidad del transportista (GET019), es obligatorio indicar la descripción del mismo (GET020) |
| Descripción del tipo de documento de identidad del transportista no corresponde al código | 4323 | Descripción del tipo de documento de identidad del transportista (GET020) no coincidente con lo informado en el campo GET019 |
| Número de documento de identidad del transportista no informado | 4324 | Si se informa el código de tipo de documento de identidad del transportista (GET019), el número de dicho documento es requerido (GET020) |
| Tipo de transporte requerido para el motivo Cambio de vehículo | 4325 | Cuando el motivo del evento es cambio de vehículo (GET003=4), es obligatorio informar el tipo de transporte (GET022) |
| Descripción del tipo de transporte es requerida | 4326 | Cuando se informa el código de tipo de transporte (GET022), es obligatorio informar la descripción del tipo de transporte (GET023) |
| Descripción del tipo de transporte no corresponde al código | 4327 | Descripción del tipo de transporte no coincidente con lo informado en el campo GET022 |
| Modalidad del transporte requerido para el motivo Cambio de vehículo | 4328 | Cuando el motivo del evento es cambio de vehículo (GET003=4), es obligatorio informar la modalidad del transporte (GET024) |
| Descripción de la modalidad del transporte es requerida | 4329 | Cuando se informa el código de la modalidad del transporte (GET024), es obligatorio informar la descripción de la modalidad del transporte (GET025) |
| Descripción de la modalidad del transporte no corresponde al código | 4330 | Descripción de la modalidad del transporte no coincidente con lo informado en el campo GET024 |
| Tipo de vehículo requerido para el motivo Cambio de vehículo | 4331 | Cuando el motivo del evento es cambio de vehículo (GET003=4), es obligatorio informar el tipo de vehículo (GET026) |
| Marca del vehículo requerida para el motivo Cambio de vehículo | 4332 | Cuando el motivo del evento es cambio de vehículo (GET003=4), es obligatorio informar la marca del vehículo (GET027) |
| Tipo de identificación del vehículo requerido para el motivo Cambio de vehículo | 4333 | Cuando el motivo del evento es cambio de vehículo (GET003=4), es obligatorio informar el tipo de identificación del vehículo (GET028) |
| Tipo de identificación del vehículo no informado | 4334 | Se requiere el número de identificación del vehículo cuando el tipo de identificación del vehículo es 1 (GET028=1) |
| Número de matrícula del vehículo no informado | 4335 | Se requiere número de matrícula del vehículo cuando el tipo de identificación del vehículo es 2 (GET028=2) |
Ejemplos de respuesta
En caso de que el resultado sea satisfactorio, la respuesta de la API es la siguiente:
{
"Success": true,
"GlobalDocumentId": "71c9747f-6d6f-a19b-6521-087525688543",
"CountryDocumentId": "01801288223001002000021222025091011125456905",
"OtherData": {
"Country": "py",
"Certifier": "SIFEN",
"AuthorityTimeStamp": "14/10/2025 13:41:40"
},
"Messages": [],
"ResponseValue": "PD94bWwgdmVyc2lvbj0iMS4w...UmV0RW52aUV2ZW50b0RlPg==",
"Code": "0600",
"Description": "Evento registrado correctamente, Evento por actualización de datos: Datos del transporte",
"ErrorException": null
}En caso de que el resultado del envío no sea satisfactorio, la API responderá con el siguiente mensaje de error:
{
"Success": false,
"GlobalDocumentId": "71c9747f-6d6f-a19b-6521-087525688543",
"CountryDocumentId": "01801288223001002000021222025091213145456905",
"OtherData": {
"Country": "py",
"Certifier": "SIFEN",
"AuthorityTimeStamp": "14/10/2025 16:19:03"
},
"Messages": [],
"ResponseValue": "PD94bWwgdmVyc2lvbj0iM...WZT4NCjwvclJldEVudmlFdmVudG9EZT4=",
"Code": "4305",
"Description": "TEST - Descripción del distrito del local de la entrega no corresponde al código",
"ErrorException": null
}