Referencia APIModelos de Datos
Factura Electrónica
Schema completo del request para emitir una Factura Electrónica (FE) con Sifende.
tipoDocumento: FACTURA_ELECTRONICA ✅ Disponible
El request de FE contiene todos los campos obligatorios para emitir una Factura Electrónica conforme a SIFEN. Se envía al endpoint polimórfico POST /api/v1/documento-electronico.
Campos comunes (base)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoDocumento | enum | Sí | Debe ser FACTURA_ELECTRONICA |
fechaEmision | datetime | Sí | ISO 8601 sin zona — YYYY-MM-DDTHH:mm:ss |
tipoEmision | enum | Sí | NORMAL (por defecto) o CONTINGENCIA |
numeroEstablecimiento | integer | Sí | 1–999, por defecto 1 |
puntoExpedicion | integer | Sí | 1–999, por defecto 1 |
monedaOperacion | enum | No | Por defecto PYG. Acepta USD, EUR, etc. |
infoEmisor | string | No | Texto libre adicional del emisor (campo SIFEN B005) |
receptor | object | Sí | Ver Receptor |
items | array | Sí | Al menos 1 ítem — ver Ítem |
Campos específicos de FE
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoTransaccion | enum | Sí | VENTA_MERCADERIA, PRESTACION_SERVICIOS, MIXTO, VENTA_ACTIVO_FIJO, VENTA_DIVISAS, ANTICIPO, VENTA_CREDITO_FISCAL — ver tipoTransaccion para la lista completa |
condicionOperacion | enum | Sí | CONTADO o CREDITO |
condicionPago | object | Sí* | Obligatorio cuando condicionOperacion = CONTADO. Ver Condición de Pago |
documentoAsociado | object | No | Para anticipos o documentos de referencia. Ver Documento Asociado |
La condición CREDITO (cuotas, plazos) está parcialmente soportada. Para producción usá CONTADO mientras tanto.
Ejemplo completo — FE B2C contado
{
"tipoDocumento": "FACTURA_ELECTRONICA",
"fechaEmision": "2026-04-15T10:30:00",
"tipoEmision": "NORMAL",
"numeroEstablecimiento": 1,
"puntoExpedicion": 1,
"monedaOperacion": "PYG",
"tipoTransaccion": "VENTA_MERCADERIA",
"condicionOperacion": "CONTADO",
"receptor": {
"tipoContribuyente": "NO_CONTRIBUYENTE",
"tipoOperacion": "B2C",
"tipoDocumento": "CEDULA_PARAGUAYA",
"numeroDocumento": "1234567",
"nombreRazonSocial": "Juan Pérez"
},
"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
202 Accepted con el DTO del documento creado en estado PENDIENTE:
{
"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"
}Ver el detalle completo de la respuesta en Emitir Documento Electrónico.