Auto Factura

POST ip:puerto/crear/autofactura/lote
POST ip:puerto/crear/autofactura/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": "001",
    "numero": "0000001", 
    "fecha": "2022-01-12T10:11:00",
    "tipoEmision": 1,
    "tipoTransaccion": 1,
    "tipoImpuesto": 1,
    "moneda": "PYG",
    "cambio": 0,
    "codigoSeguridadAleatorio": 228345,
    "condicion": {}, // ver detalles mas abajo
    "items": [ // ver detalles mas abajo
      {
        "codigo": "TEST001",
        "descripcion": "ARTICULO PRUEBA NRO 1",
        "unidadMedida": 77,
        "cantidad": 1.00,
        "precioUnitario": 5500
      }
    ],
    "autoFactura": {
      "tipoVendedor" : 1,
      "documentoTipo" : 1,
      "documentoNumero" : "123465",
      "nombre": "Juan López",
      "direccion" : "Area 4",
      "numeroCasa" : "001",
      "departamento" : 11,
      "distrito" : 145,
      "ciudad" : 3420
    },
    "documentoAsociado": {
      "formato": 3,
      "constanciaTipo": 1,
      "constanciaNumero": 42804571677,
      "constanciaControl": "8f9708d2"
    }
  }
}

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 artículos, a diferencia de la factura, para la auto factura estos son los únicos datos requeridos
• 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.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í
• documento.autoFactura array con información de la persona no contribuyente del cual adquirimos productos/servicios, encontrarás los detalles aquí
• documento.documentoAsociado array con la información de la constancia de No Contribuyente del proveedor, encontrarás los detalles aquí