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.
`tipoCambio`	`number`	Condicional	D018 global. Obligatorio para moneda extranjera en modalidad GLOBAL; no se informa en PYG ni en POR_ITEM
`descuentoGlobalPorcentaje`	`number`	No	Porcentaje global mayor que 0 y menor o igual a 100, aplicado al precio unitario de cada ítem
`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 para `CONTADO` y `CREDITO`; `tipo` debe coincidir con `condicionOperacion`. Ver Condición de Pago
`documentoAsociado`	`object`	No	Para anticipos o documentos de referencia. Ver Documento Asociado

Las facturas a crédito admiten dos modalidades excluyentes: PLAZO, con un texto de plazo, y CUOTA, con cantidad y detalle de cada cuota. Por ahora sólo se aceptan en monedaOperacion: "PYG".

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 requests completos validados contra OpenAPI.

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.

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": "7",
    "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
    }
  ]
}

Estos dos ejemplos coinciden con el contrato publicado en OpenAPI. Para agregar una entrega inicial positiva, incluí tipoPago, monedaPago: "PYG" y montoEntregaInicial dentro de condicionPago; el monto no puede superar el total fiscal de los ítems.

Los errores del contrato de crédito devuelven 400 validation-error antes de reservar el número del documento. Un request rechazado por estas validaciones no consume secuencia ni crea el documento electrónico.

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.