#Enviar un comprobante y consultar su estado

#Descripción

Este endpoint permite enviar comprobantes electrónicos al SIFEN y consultar su estado de procesamiento. Es compatible con facturas, notas de crédito, autofacturas, notas de remisión y otros tipos de comprobantes admitidos por la API.

Si el comprobante está guardado, rechazado o en proceso, este endpoint gestionará el envío al SIFEN o la consulta de su estado, según corresponda.

#Endpoint

POST /api/sri_documents/:ID/send?xml=1

Reemplaza :ID por el identificador del documento que deseas consultar.

#Autenticación

La solicitud requiere un token Bearer válido.

Incluye el encabezado Authorization de la siguiente manera:

Authorization: Bearer TU_TOKEN

#Parámetros de la solicitud

#Parámetros de la URL

Parámetro	Tipo	Obligatorio	Descripción
ID	integer	Sí	Identificador del comprobante que se desea enviar o consultar.
xml	integer	No	Indica si se debe incluir el XML en la respuesta. Utiliza 1 para recuperar el XML y 0 para no incluirlo.

#Cuerpo de la solicitud

El cuerpo de la solicitud debe enviarse como un objeto JSON vacío:

{}

#Ejemplo de solicitud

POST /api/sri_documents/177/send?xml=1
Authorization: Bearer TU_TOKEN
Content-Type: application/json

#Respuesta cuando el comprobante está aprobado

Cuando el comprobante ha sido autorizado por el SIFEN, la API devuelve su información y la fecha de aprobación.

#Ejemplo de respuesta

{
    "id": 177,
    "claveAccesso": "01800870883001001000058222026100917915733221",
    "secuencial": "0000582",
    "estado": "APROBADO",
    "serie1": "001",
    "serie2": "001",
    "approvedDate": "2026-10-09T16:16:04-03:00",
    "qr": "https://ekuatia.set.gov.py/consultas-test/qr?nVersion=150&Id=01800870883001001000058222026100917915733221&dFeEmiDE=323032362d31302d30395431363a31333a3030&dNumIDRec=EQ5369854&dTotGralOpe=46.36000000&dTotIVA=1.94181818&cItems=2&DigestValue=49664265726c4b4372693655416950465137736b786a496433385868795379492f466945472b39766a334d3d&IdCSC=0001&cHashQR=2321bf9fc249e4b374a493d34599fcd624fe87d8ff25fadf9ca09a8701fe9bb2"
}

#Campos de la respuesta

Campo	Tipo	Descripción
id	integer	Identificador del comprobante en la API.
claveAccesso	string	CDC del comprobante electrónico.
secuencial	string	Número secuencial del comprobante.
estado	string	Estado actual del comprobante. En este ejemplo, APROBADO.
serie1	string	Primera parte de la serie del comprobante.
serie2	string	Segunda parte de la serie del comprobante.
approvedDate	string	Fecha y hora de aprobación, en formato ISO 8601 con zona horaria.
qr	string	URL del código QR utilizado para consultar la información del comprobante.

#Respuesta cuando el comprobante es rechazado

Si el SIFEN rechaza el comprobante, la API devuelve el estado RECHAZADO y, cuando está disponible, el motivo del rechazo.

#Ejemplo de respuesta

{
    "id": 181,
    "claveAccesso": "05800870883001001000000522026100917915837784",
    "secuencial": "0000005",
    "estado": "RECHAZADO",
    "error": "TEST - El CDC informado corresponde a un DTE cancelado",
    "serie1": "001",
    "serie2": "001",
    "qr": "https://ekuatia.set.gov.py/consultas-test/qr?nVersion=150&Id=05800870883001001000000522026100917915837784&dFeEmiDE=323032362d31302d30395431393a30393a3030&dNumIDRec=EQ5369854&dTotGralOpe=35.68000000&dTotIVA=0.97090909&cItems=2&DigestValue=36312b3443306438436f57786533355944614d646570746752525578644a73564b514776324441346a4e493d&IdCSC=0001&cHashQR=ed377b4914b7e1aa29708cebedde659abc5e45affee8029e7864bb787bce87c6",
    "xml": "el xml"
}

#Campos adicionales

Campo	Tipo	Descripción
error	string	Mensaje que explica el motivo del rechazo, cuando está disponible.
xml	string	Contenido XML del comprobante, cuando se solicita mediante el parámetro xml=1 y la API dispone de él.

Los campos id, claveAccesso, secuencial, estado, serie1, serie2 y qr tienen el mismo propósito que en la respuesta de un comprobante aprobado.

#Consultar el XML

Para obtener el XML del comprobante en la respuesta, utiliza el parámetro xml=1.

Ejemplo:

POST /api/sri_documents/181/send?xml=1

Si no necesitas recuperar el XML, utiliza xml=0 o, omite el parámetro.

#Consideraciones importantes

• Envía siempre un token Bearer válido en el encabezado Authorization.
• Sustituye :ID por el identificador real del comprobante.
• La respuesta puede variar según el estado del comprobante y la información disponible.
• Un estado RECHAZADO indica que el comprobante no fue autorizado. Consulta el campo error para identificar el motivo y determinar qué debes corregir.
• Una solicitud de envío no garantiza la aprobación del comprobante. La autorización depende de las validaciones y de la respuesta del SIFEN.
• El parámetro xml controla la inclusión del XML en la respuesta; no modifica por sí mismo el estado del comprobante.