Factura Electrónica

tipoDocumento: FACTURA_ELECTRONICA ✅ Disponible

La solicitud 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)

Obligaciones afectadas

obligacionesAfectadas admite los códigos "113", "143", "211", "311", "321", "700", "701", "702", "703", "715" y "716", como strings. Por ejemplo: "obligacionesAfectadas": ["211", "700"]. Se admite en FE, NCE y NDE. En NRE debe omitirse: incluso una lista vacía recibe 400 validation-error.

Campos específicos de FE

condicionPago y pagos/credito son formas excluyentes. Las facturas a crédito admiten dos modalidades: PLAZO, con un texto libre o { cantidad, unidad }, y CUOTA, con el calendario completo de cuotas, que debe sumar el saldo financiado. El crédito admite cualquier moneda de operación.

Para una operación en moneda extranjera al contado, elegí una sola modalidad: tipoCambio en la factura (GLOBAL) o tipoCambio en todos los ítems (POR_ITEM). Consultá Facturar en Moneda Extranjera para ver solicitudes completas.

Para descuentos, informá solamente las decisiones comerciales: descuentoParticular como importe por unidad dentro del ítem y descuentoGlobalPorcentaje una vez en el documento. Sifende deriva los porcentajes e importes técnicos del XML, los subtotales, el IVA y el total neto. En PYG los importes globales derivados se redondean a entero con half-up; en otras monedas conservan hasta 8 decimales.

Si la operación lleva una comisión aparte de los ítems, informala en comision con el IVA incluido. Sifende la suma al total general, calcula su IVA al 10% y lo agrega al total de IVA. Los pagos de contado deben cubrir el total general con la comisión incluida. Se admite en FE, NCE y NDE. No se admite un total aparte de operación más comisión: el total general ya la incluye.

Compras públicas

Los datos de contratación DNCP son opcionales en cualquier tipo de operación: B2B, B2C, B2G o B2F. Cuando el receptor es un organismo público, además debe cumplir las reglas B2G.

Campos de comprasPublicas

Enviá los códigos como strings con sus ceros iniciales. La API no acepta números JSON ni completa los ceros. Ejemplo del bloque, para una FE cuya fecha efectiva sea posterior al 10 de enero de 2026:

{
  "comprasPublicas": {
    "modalidad": "CD",
    "entidad": "00123",
    "anho": "26",
    "secuencia": "0000456",
    "fechaEmisionCodigo": "2026-01-10"
  }
}

Los ítems pueden incluir codigoDncpGeneral (string de 8 dígitos) y codigoDncpEspecifico (string de 3 a 4 dígitos), también en cualquier operación. Ver Ítem. Un formato de campo inválido recibe 400. Si fechaEmisionCodigo no es anterior a la fecha de emisión de la factura, la respuesta es 422 public-procurement-data-invalid.

Documentos asociados y anticipos

documentosAsociados lista, en orden, los documentos que respaldan la factura. Una factura sólo se asocia a una nota de remisión o a una factura de anticipo, electrónica o impresa. El campo singular documentoAsociado es de las notas de crédito y débito: en una factura recibe 400 validation-error, también si hay un solo documento.

Una venta de crédito fiscal (tipoTransaccion: "VENTA_CREDITO_FISCAL") informa al menos un documento asociado, y cada uno lleva su numeroResolucionCreditoFiscal.

numeroComprobanteRetencion es opcional aunque haya un pago RETENCION. El Manual Técnico lo marca opcional en la tabla del campo y obligatorio en la regla 2412; SIFEN hoy no aplica esa regla. El comprobante viaja dentro de un documento asociado admitido (nota de remisión o factura de anticipo): no se informa sin una asociación.

Un documento electrónico asociado emitido con Sifende se valida antes de firmar la factura. La respuesta es 400 validation-error, con el error en errores["documentosAsociados[i]"], cuando:

Sólo se admiten documentos APROBADO o APROBADO_OBSERVACION: si todavía está pendiente, esperá su aprobación antes de emitir la factura.

Para aplicar un anticipo ya facturado, asociá la factura de anticipo y declará cuánto se aplica en esta factura:

• ANTICIPO_GLOBAL: anticipoGlobalPorcentaje se aplica al precio unitario de todos los ítems.
• ANTICIPO_POR_ITEM: cada ítem que aplica anticipo informa anticipoParticular, el importe por unidad.

Con una sola factura de anticipo electrónica asociada, todos los ítems la referencian en el XML sin que informes cdcAnticipo, también los que no aplican anticipo. Con varias, cada ítem indica la suya con cdcAnticipo, aplique o no anticipo; un ítem sin cdcAnticipo recibe 400 en items[i].cdcAnticipo. Una factura de anticipo asociada debe aplicarse en al menos un ítem: asociarla sin condicionAnticipo ni importe de anticipo recibe 400 en condicionAnticipo.

El anticipo reduce el total de cada ítem. El emisor controla cuánto de cada anticipo queda por aplicar.

{
  "documentosAsociados": [
    { "tipoDocumento": "ELECTRONICO", "cdc": "01800123451001001000000122026042710000000006" }
  ],
  "condicionAnticipo": "ANTICIPO_GLOBAL",
  "anticipoGlobalPorcentaje": 30
}

Datos comerciales

Datos sectoriales

• energia: cada medición informa numeroMedidor, codigoActividad, codigoCategoria, lecturaAnterior, lecturaActual y consumo. La lectura actual no puede ser menor que la anterior, y el consumo es la diferencia entre ambas.
• seguro: codigoEmpresa y polizas. Cada póliza informa codigo, numero, vigencia y unidadVigencia, y opcionalmente fechaInicioVigencia y fechaFinVigencia (YYYY-MM-DDTHH:mm:ss, por ejemplo 2026-01-01T00:00:00; el fin no puede ser anterior al inicio) y codigoItem, que debe ser el código de un ítem de la factura.
• supermercado: nombreCajero, efectivo, vuelto, donacion y descripcionDonacion. El vuelto y la donación no pueden superar el efectivo recibido.

Transporte y carga

transporte es opcional en una factura y usa los mismos campos que el transporte de la nota de remisión: modalidad y responsableFlete son obligatorios; tipoTransporte, fechas del traslado, incoterm, numeroManifiesto, numeroDespachoImportacion, paisDestino, salida, entregas, vehiculos y transportista se informan cuando corresponden. Si informás el transportista, su domicilio fiscal y la dirección del conductor son obligatorios.

carga informa volumenTotal y pesoTotal como enteros positivos en string, con sus unidades, y una caracteristica. Con caracteristica: "OTRO" se describe la carga en descripcionCaracteristica.

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": 11000,
      "afectacionTributaria": "GRAVADO",
      "tasaIVA": 10
    }
  ]
}

Ejemplos completos — FE a crédito

{
  "tipoDocumento": "FACTURA_ELECTRONICA",
  "fechaEmision": "2026-09-18T10:30:00",
  "tipoEmision": "NORMAL",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "tipoTransaccion": "VENTA_MERCADERIA",
  "monedaOperacion": "PYG",
  "receptor": {
    "tipoContribuyente": "CONTRIBUYENTE",
    "tipoOperacion": "B2B",
    "tipoContribuyenteReceptor": "PERSONA_JURIDICA",
    "numeroDocumento": "80012345",
    "digitoVerificador": "0",
    "nombreRazonSocial": "Comercial San Roque S.A."
  },
  "condicionOperacion": "CREDITO",
  "condicionPago": {
    "tipo": "CREDITO",
    "condicionCredito": "PLAZO",
    "plazoCredito": "30 días",
    "montoEntregaInicial": 0
  },
  "items": [
    {
      "codigo": "PROD-001",
      "descripcion": "Resma de papel A4 75g",
      "cantidad": 10,
      "unidadMedida": "UNI",
      "precioUnitario": 12000,
      "afectacionTributaria": "GRAVADO",
      "tasaIVA": 10
    }
  ]
}

Para agregar una entrega inicial positiva, incluí tipoPago, monedaPago y montoEntregaInicial dentro de condicionPago, o informala en pagos. Se expresa en la moneda de la operación y debe ser menor que el total.

Respuesta

202 Accepted con los datos del documento creado en estado PENDIENTE:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdc": "01800123451001001000000122026042710000000006",
  "estado": "PENDIENTE",
  "ambiente": "DEV",
  "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.

Próximos pasos

• Consultar el estado del documento
• Descargar el KuDE en PDF
• Receptor B2B vs B2C