📑 Paginación de Registros de Compras

Este servicio permite listar los registros de compras almacenados en el sistema de forma paginada.
Se pueden aplicar filtros por periodo, año, número de factura o CUF.

---

🔗 Endpoint

GET https://sandbox.cucu.ai/api/v1/invoice/shopping/PageShopping

---

📥 Parámetros de Consulta

Parámetro	Tipo	Requerido	Descripción
size	Int	Sí	Cantidad de resultados por página.
page	Int	Sí	Número de página a consultar (empezando en 0).
period	Int	No	Periodo de facturación (ejemplo: 9 para septiembre).
year	Int	No	Año de facturación.
invoiceNumber	Int	No	Número de factura para filtrar.
cuf	String	No	Código Único de Factura (CUF) para filtrar.

---

📤 Ejemplo de Request

GET https://sandbox.cucu.ai/api/v1/invoice/shopping/PageShopping?size=10&page=0&period=9&year=2025&invoiceNumber=1520&cuf=2872F72944FB3725D2A78B1D96F4D2BF0CAAF821415BA231E54A12F74

---

📥 Ejemplo de Response

{
  "message": "COMPLETE",
  "errors": null,
  "success": true,
  "data": {
    "totalItems": 1,
    "totalPages": 1,
    "limit": 10,
    "page": 0,
    "prevPage": null,
    "nextPage": null,
    "result": [
      {
        "shoppingInvoiceId": 163,
        "number": 1572,
        "issuerNit": "591164023",
        "issuerBusinessName": "CUCU S.R.L",
        "authorizationCode": "2872F72944FB381221F5CC5AB5DDF70A1CB0FB2E86014FEE907B12F74",
        "invoiceNumber": "1572",
        "duiDimNumber": "0",
        "emissionDate": "2025-09-10T22:30:00",
        "totalPurchaseAmount": 2.00,
        "iceAmount": 0.00,
        "iehdAmount": 0.00,
        "ipjAmount": 0.00,
        "rates": 0.00,
        "otherNotSubjectToCredit": 0.00,
        "exemptAmounts": 0.00,
        "zeroRateAmount": 0.00,
        "subtotal": 2.00,
        "discount": 0.00,
        "giftCardAmount": 0.00,
        "totalAmountSubjectToVat": 2.00,
        "fiscalCredit": 0.26,
        "purchaseType": 5,
        "controlCode": "0",
        "responseCode": 2217,
        "responseDescription": "Compra eliminada con éxito.",
        "responseCodeDescription": "ELIMINADO",
        "responseCodeReception": "57eae6f9-d8d3-4627-9d0e-1e99c16615c0",
        "responseCodeStatus": "8415",
        "transactionStatus": true,
        "isConfirmed": true,
        "validDescription": "1572: La compra ya se encuentra confirmada",
        "isValidated": true
      }
    ]
  }
}

---

✅ Notas

• 📌 Se recomienda usar paginación para evitar sobrecarga de datos.
• 📌 Los filtros (period, year, invoiceNumber, cuf) son opcionales, pero permiten búsquedas más específicas.