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",
    "fecha": "2022-08-18T10:11:00",
    "tipoEmision": 1,
    "tipoTransaccion": 1,
    "tipoImpuesto": 1,
    "moneda": "PYG",
    "cambio": null,
    "codigoSeguridadAleatorio": 2,
    "cliente": {}, // ver detalles mas abajo
    "factura": { "presencia": 1 },
    "condicion": { // ver detalles mas abajo
      "tipo": 1,
      "entregas": [],
      "credito": []
    },
    "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.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.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 el dato de tipo y como cargar el array de entregas, encontrarás los datos aquí
  • Si la venta es a crédito, podrás encontrar los detalles puntuales encontrarás los valores para este campo aquí