Saltar al contenido principal

Cancelación de documentos

La API en Paraguay y Panamá ofrece la opción de automatizar el proceso de cancelación de documentos. Para hacer esto, es necesario utilizar método ChangeDocumentStatus con los siguientes parámetros:

ChangeDocumentStatus para cancelación (request)
ParámetroTipoDescripciónValores permitidos
countryDocumentIdStringIdentificador fiscal del documento a nivel país, conocido también como CUFE, CLAVE, UUID, IDVer tabla Estructura Country Document ID
DescriptionStringRazón de la cancelaciónCaracteres alfanuméricos.
StatusStringCódigo de cancelación: 4Caracteres numéricos

Ejemplo de petición

image-20240221-230629.png

 Para este método utilizamos la pestaña Params de Postman.

  1. Seleccione el tipo de método. En este caso, se debe seleccionar POST.
  2. Ingrese la URL del método.
  3. Ingrese los parámetros que se muestran en la tabla anterior con sus valores correspondientes.
  4. Presione Send.

 Si el evento se genera satisfactoriamente, entonces se envía a la Entidad Tributaria para su validación y aceptación.


Ejemplo de respuesta

La Entidad Tributaria responde a través de la API de la siguiente forma.

image-20240311-214500.png

El registro de esta solicitud y su mensaje de aceptación quedarán registrados en las notas de la vista previa del documento en Inbox.

image-20240311-214745.png

Además, se mostrará adjunto el XML del evento enviado a la Entidad Tributaria.

image-20240311-214909.png

En la pantalla de consulta de Inbox, el documento se mostrará con el estado Anulado.

image-20240311-215018.png

Si el resultado del envío NO es satisfactorio, la API de Inbox responderá con el siguiente mensaje de error:

{
"ErrorMessage": null,
"IsValid": false,
"StatusCode": "500",
"StatusDescription": null,
"StatusMessage": " El estado del documento no fue actualizado correctamente",
"XmlBase64Bytes": null,
"XmlBytes": null,
"XmlDocumentKey": null,
"XmlFileName": null,
"ResponseType": null,
"OtherData": null,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"Timestamp": null,
"Response": null,
"TaxDocument": null
}

El registro de esta solicitud y el mensaje de error se mostrará en las notas de la vista previa del documento dentro de Inbox.

image-20240311-231355.png

En caso de que el documento haya sido previamente cancelado, se mostrará la siguiente respuesta:

image-20240311-231513.png