Anular documento electrónico

Anula un documento electrónico previamente emitido. Permite invalidar un documento fiscal ya generado ante SIFEN mediante un evento de anulación.

Importante: La anulación solo es válida dentro de las primeras 48 horas posteriores a la emisión del documento electrónico. Después de este plazo, el documento no podrá ser anulado.

Entorno

URL base: https://api.guarani.app

Endpoint

POST /sifen/eventos/anular

Ejemplo de solicitud

curl --location 'https://api.guarani.app/sifen/eventos/anular' \
  --header 'x-api-key: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "cdc": "cdc",
    "motivo": "Mensaje de anulacion Ejemplo: de Error de impresion del documento electronico"
}'

Nota: Asegúrate de reemplazar <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían en formato JSON.
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.

Descripción de Campos

Campo	Tipo	Requerido	Descripción
cdc	string	Sí	Código de control del documento electrónico que se desea anular.
motivo	string	Sí	Descripción del motivo por el cual se anula el documento electrónico.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": {
    "ns2:rRetEnviEventoDe": {
      "$": {
        "xmlns:ns2": "http://ekuatia.set.gov.py/sifen/xsd"
      },
      "ns2:dFecProc": "2025-10-28T08:34:53-03:00",
      "ns2:gResProcEVe": {
        "ns2:dEstRes": "Aprobado",
        "ns2:dProtAut": "1050247",
        "ns2:id": "15",
        "ns2:gResProc": {
          "ns2:dCodRes": "0600",
          "ns2:dMsgRes": "Evento registrado correctamente"
        }
      }
    }
  }
}

Para más información sobre posibles errores de certificados, consulta las siguientes secciones: errores.