Paso 2: Tu Primera Factura Electrónica
Emití tu primera Factura Electrónica
Un endpoint para todos los tipos de documento. Sifende usa un único endpoint POST /api/v1/documento-electronico para todos los tipos de documento electrónico. El campo tipoDocumento define qué tipo emitís. Más información en Emitir Documento Electrónico.
Tu primera factura
Para tu primer ejemplo usamos un receptor INNOMINADO: un consumidor final anónimo (sin cédula, sin RUC). Es el caso más simple y permite emitir facturas válidas sin pedirle datos al comprador.
¿Querés hacer todo esto más rápido? Probá la Sifende CLI: emite, consulta estado y descarga el KuDE desde la terminal con tres comandos.
curl -X POST https://api.sifende.com.py/api/v1/documento-electronico \
-H "Authorization: Bearer $SIFENDE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tipoDocumento": "FACTURA_ELECTRONICA",
"fechaEmision": "2026-04-15T10:30:00",
"tipoEmision": "NORMAL",
"numeroEstablecimiento": 1,
"puntoExpedicion": 1,
"tipoTransaccion": "VENTA_MERCADERIA",
"monedaOperacion": "PYG",
"receptor": {
"tipoContribuyente": "INNOMINADO",
"tipoOperacion": "B2C",
"nombreRazonSocial": "Sin Nombre"
},
"condicionOperacion": "CONTADO",
"condicionPago": {
"tipo": "CONTADO",
"tipoPago": "EFECTIVO",
"monedaPago": "PYG",
"montoPago": 110000
},
"items": [
{
"codigo": "PROD-001",
"descripcion": "Resma de papel A4 75g",
"cantidad": 10,
"unidadMedida": "UNI",
"precioUnitario": 10000,
"afectacionTributaria": "GRAVADO",
"tasaIVA": 10
}
]
}'Respuesta exitosa
Si el documento se aceptó, la API responde 202 Accepted con un DTO completo:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"cdc": "01800123451001001000000122026042710000000006",
"estado": "PENDIENTE",
"tipoDocumento": "FACTURA_ELECTRONICA",
"iTiDe": 1,
"numeroDocumento": 1,
"numeroFormateado": "001-001-0000001",
"fechaCreacion": "2026-04-27T10:30:00",
"qrUrl": "https://ekuatia.set.gov.py/consultas-test/qr?...",
"statusUrl": "https://api.sifende.com.py/api/v1/documento-electronico/status/01800123451001001000000122026042710000000006",
"kudeUrl": "https://api.sifende.com.py/api/v1/documento-electronico/01800123451001001000000122026042710000000006/kude"
}El campo cdc contiene el Código de Control del Documento Electrónico: 44 caracteres que identifican a tu documento en SIFEN. Guardalo junto con el id: los vas a necesitar para consultar estado, descargar el KuDE y cancelar.
202 Accepted, no 200 OK. El estado inicial siempre es PENDIENTE: el documento aún no fue procesado por SIFEN. Mirá el Paso 3 para hacer polling del estado real.
Los montos en guaraníes (PYG) son números enteros sin decimales. 10000 = Gs. 10.000. Ver Convenciones para más detalles.
Con receptor identificado
Si tu cliente da su cédula o RUC, podés emitir la factura a su nombre. Reemplazá el bloque receptor del ejemplo anterior por alguno de los siguientes.
Receptor B2C con cédula:
"receptor": {
"tipoContribuyente": "NO_CONTRIBUYENTE",
"tipoOperacion": "B2C",
"tipoDocumento": "CEDULA_PARAGUAYA",
"numeroDocumento": "1234567",
"nombreRazonSocial": "Juan Pérez"
}Para receptores B2B (con RUC) y otros casos, consultá la guía Receptor B2B vs B2C.
¿Algo salió mal?
Consultá Errores Comunes o la Referencia de Errores.
Seguí con Paso 3: Verificar el Estado.