Proceso de cancelación
La API en 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ámetro | Tipo | Descripción | Valores permitidos |
| countryDocumentId | String | Identificador fiscal del documento a nivel país, conocido también como CUFE, CLAVE, UUID, ID | Ver tabla Estructura Country Document ID |
| Reason | String | Razón de la cancelación | Caracteres alfanuméricos. |
| Status | String | Código de cancelación: 4 | Caracteres numéricos |
Ejemplo de petición
Para este método utilizamos la pestaña Params 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.
Si el evento se genera satisfactoriamente, entonces se envía a la Entidad Tributaria para su validación y aceptación.
Ejemplo de respuesta
Al tratarse de un método síncrono, la respuesta es recibida inmediatamente. En caso de que el resultado sea satisfactorio, la API responderá de la siguiente forma:
Para interpretar correctamente la respuesta de la Entidad Tributaria, tome en cuenta lo siguiente:
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.
Además, se mostrará adjunto el XML del evento enviado a la Entidad Tributaria.
En la pantalla de consulta de Inbox, el documento se mostrará con el estado Anulado.
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.
En caso de que el documento haya sido previamente cancelado, se mostrará la siguiente respuesta:
