Emitir un documento electrónico
Actualizado el
Registra el documento y lo encola para SIFEN. La respuesta es inmediata y el CDC ya
viene calculado, pero el envío ocurre en segundo plano: estado es siempre
PENDIENTE acá. El estado final se consulta con el statusUrl de la respuesta.
El emisor no se envía en el body: sale de la API key. El timbrado lo toma Sifende del
ambiente. El correlativo también lo asigna Sifende, salvo que tu sistema numere por su
cuenta: con numeroDocumento se usa ese número en lugar del siguiente (y opcionalmente
codigoSeguridad y numeroTimbrado). Un número ya usado devuelve 409 con
document-number-in-use y el CDC existente; uno inutilizado, 409 con
document-number-voided; un numeroTimbrado distinto del cargado, 422 con
timbrado-mismatch. Un número cuyo documento fue RECHAZADO devuelve 422 con
document-number-requires-voiding: hay que inutilizarlo y emitir con otro número.
Authorization
apiKey API key de Sifende en el header Authorization: Bearer {api-key}.
Además de autenticar, fija el contribuyente emisor y un ambiente inmutable DEV, PROD o
SANDBOX: por eso ninguno de los dos se envía en el body.
En PROD, la clave requiere un plan que incluya la API de integración; si no, toda ruta
responde 403 plan-operation-not-allowed, salvo las bajas: revocar la propia clave
(DELETE /api/v1/contribuyente/api-key) y eliminar un webhook.
In: header
Header Parameters
Clave opcional para identificar una intención idempotente en operaciones compatibles. Acepta un solo valor de 1 a 255 caracteres ASCII visibles, sin espacios al inicio ni al final. El alcance es por contribuyente y ambiente, compartido entre los tipos de operación. Una clave existente resuelve la operación original sin comparar el body ni el CDC posterior. Otro tipo de operación devuelve 422. El cliente debe persistir la clave y la solicitud original y generar una clave nueva para cada intención nueva. El replay dura 7 días desde la finalización; después la clave sigue reservada hasta que termina la conservación del documento. La solicitud debe poder deserializarse; los campos del body se validan sólo para operaciones nuevas.
^[!-~](?:[ -~]{0,253}[!-~])?$1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Factura electrónica — tipoDocumento = FACTURA_ELECTRONICA.
Response Body
application/json
application/problem+json
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.sifende.com.py/api/v1/documento-electronico" \ -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \ -H "Content-Type: application/json" \ -d '{ "tipoDocumento": "FACTURA_ELECTRONICA", "tipoEmision": "NORMAL", "numeroEstablecimiento": 0, "puntoExpedicion": 0, "tipoTransaccion": "PRESTACION_SERVICIOS", "condicionOperacion": "CREDITO", "condicionPago": { "condicionCredito": "PLAZO", "tipo": "CREDITO" }, "monedaOperacion": null }'{ "id": "550e8400-e29b-41d4-a716-446655440000", "deId": 4821, "cdc": "01800123451001001000000122026042710000000006", "estado": "PENDIENTE", "tipoDocumento": "FACTURA_ELECTRONICA", "iTiDe": 1, "numeroDocumento": 122, "numeroFormateado": "001-001-0000122", "fechaCreacion": "2026-04-27T10:30:00", "qrUrl": "https://ekuatia.set.gov.py/consultas-test/qr?nVersion=150&Id=018001234510010010000001220260427100000000006", "statusUrl": "https://api.sifende.com.py/api/v1/documento-electronico/status/01800123451001001000000122026042710000000006", "kudeUrl": "https://api.sifende.com.py/api/v1/documento-electronico/01800123451001001000000122026042710000000006/kude"}