SIFENDE
Referencia APIExplorador de la API

Emitir un documento electrónico

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 y el correlativo los asigna Sifende.

POST
/api/v1/documento-electronico

Authorization

apiKey
AuthorizationBearer <token>

API key de Sifende en el header Authorization: Bearer sk_live_.... Además de autenticar, fija el contribuyente emisor: por eso el emisor no se envía en el body.

In: header

Header Parameters

Idempotency-Key?string

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.

Match^[!-~](?:[ -~]{0,253}[!-~])?$
Length1 <= length <= 255

Request 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://example.com/api/v1/documento-electronico" \  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \  -H "Content-Type: application/json" \  -d '{    "tipoDocumento": "FACTURA_ELECTRONICA",    "fechaEmision": "string",    "tipoEmision": "NORMAL",    "numeroEstablecimiento": 0,    "puntoExpedicion": 0,    "receptor": {      "tipoOperacion": "B2B",      "nombreRazonSocial": "string",      "tipoDocumento": null,      "direccion": "string",      "digitoVerificador": "string",      "numeroDocumento": "string",      "tipoContribuyente": "CONTRIBUYENTE",      "pais": "PRY"    },    "tipoTransaccion": "PRESTACION_SERVICIOS",    "condicionPago": {      "tipo": "CREDITO",      "plazoCredito": "string",      "condicionCredito": "PLAZO",      "monedaPago": "PYG",      "tipoPago": null    },    "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"}

OpenAPI y JSON Schema

Spec OpenAPI 3.1 de la API de Sifende, generado desde el código — URLs estables para fijar en tu build, validación local de requests y generación de clientes.

Consultar el estado de un documento GET

Estados terminales: APROBADO, APROBADO_OBSERVACION, RECHAZADO y ERROR. APROBADO_OBSERVACION es un resultado exitoso.