Factura (Contado/Crédito)

POST ip:puerto/crear/factura/lote
POST ip:puerto/crear/factura/online

Por defecto, la SIFEN habilita únicamente el envío de documentos por lote a todos los contribuyentes

Ejemplo del body

NOTE

Encontrarás toda la información relevante a distintos campos y parámetros mas abajo, en Detalles del Documento

{
  "usuario": "juan_lopez",
  "returnQr": true,
  "documento": {
    "establecimiento": "001",
    "punto": "002",
    "numero": "0000123",
    "observacion": "Alguna observación relevante para la operacion que se anexará en el XML",
    "fecha": "2022-08-18T10:11:00",
    "tipoEmision": 1,
    "tipoTransaccion": 1,
    "tipoImpuesto": 1,
    "moneda": "PYG",
    "cambio": null,
    "descuentoGlobal": 45000, // ver detalles mas abajo
    "codigoSeguridadAleatorio": 2,
    "cliente": {}, // ver detalles mas abajo
    "factura": { "presencia": 1 },
    "condicion": {}, // ver detalles mas abajo
    "obligaciones": [
      { "codigo": 211 },
      { "codigo": 311 }
    ],
    "items": [ // ver detalles mas abajo
      {
        "codigo": "TEST001",
        "descripcion": "ARTICULO PRUEBA NRO 1",
        "unidadMedida": 77,
        "cantidad": 1.00,
        "precioUnitario": 5500,
        "descuento": 0,
        "ivaTipo": 1,
        "ivaBase": 100,
        "iva": 10
      }
    ]
  }
}

Ejemplos de la respuesta

{
  "status": true,
  "requestId": "8bc559e0-0032-41d7-96fc-513650da9a39",
  "message": "La factura se ha generado y programado para su emisión a la SET.",
  "kude": {
    "CDC": "13241324132413241324132413241324132413241324",
    "formattedCDC": "1234 1234 1234 1234 1234 1234 1234 1234 1234 1234 12343544",
    "url": "https://ekuatia.set.gov.py/consultas/...",
    "base64": "data:image/gif;base64,..." // caso returnQr sea true
  }
}

{
  "status": false,
  "requestId": "cc91b700-896a-4490-b927-075cbdb0a6cd",
  "message": "Valor de la Fecha '2024-11-16T1s6:30:21' en data.fecha no válido. Formato: yyyy-MM-ddTHH:mm:ss",
  "details": []
}

Detalles del documento

• usuario usuario de emisión del documento
• returnQr (boolean) para recibir el base64 del código QR
• documento.establecimiento número de sucursal
• documento.punto número de caja
• documento.numero número de documento
• documento.observacion string de observación relacionado a la venta que se anexará en el XML (hasta 2000 caracteres), de no tener observación por mandar, se puede omitir este campo en el JSON
• documento.fecha timestamp creación de la factura
• documento.tipoEmision (usualmente será 1 normal)
• documento.tipoTransaccion encontrarás los valores para este campo aquí
• documento.tipoImpuesto encontrarás los valores para este campo aquí
• documento.moneda moneda en la que se emite el documento
• documento.cambio si es PYG enviar como null
• documento.descuentoGlobal (opcional, en caso de no tener no enviar este campo), es el importe de descuento que se dará sobre la totalidad de la operación (no es descuento fijo por producto)
• documento.items array de los artículos vendidos, encuentra mas detalles aquí
• documento.codigoSeguridadAleatorio código de Seguridad (generado lado cliente de hasta 9 dígitos). Importante: Esta información deberás almacenar de tu lado, de forma que si el documento sea rechazado, puedas corregir los detalles para reemitir el documento sin inconvenientes y que el CDC no presente variaciones
• documento.cliente encontrarás los ejemplos de usos mas cotidianos aquí
• documento.factura.presencia encontrarás los valores para este campo aquí
• documento.condicion array con información referente a la forma de pago.
  • Para conocer la estructura según el tipo de condición accede aquí
  • Para la información de formas de pago, encontrarás los datos accede aquí