Buscar recepciones de compras

POST/api/v1/compras/buscar

Lista únicamente las recepciones de la empresa y el ambiente asociados a X-API-Key. Requiere el permiso facturas.consultar.

Header requerido X-API-KeyVer operaciones de Recepción de compras

Contrato de la operación

Lista únicamente las recepciones de la empresa y el ambiente asociados a X-API-Key. Requiere el permiso facturas.consultar.

page comienza en 0; size usa 20 por defecto y admite hasta 100. sortBy acepta fechaEnvio, periodoFiscal o estado; sortDir acepta asc y desc. Los filtros admitidos son estado, operacion, periodoFiscal, codigoPuntoVenta, codigoRecepcion y hashArchivo; sus valores se envían como texto. operacion admite registro y confirmacion; si se omite, incluye ambas operaciones. periodoFiscal usa AAAA-MM y ordena por año y mes juntos. Los antiguos filtros y ordenamientos gestion y periodo devuelven 400. Responde 200, 400, 401 o 403.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "page": 0,
  "size": 20,
  "sortBy": "fechaEnvio",
  "sortDir": "desc",
  "filters": {
    "periodoFiscal": "2026-08",
    "estado": "aceptado"
  }
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "recepciones de compras obtenidas correctamente",
  "data": {
    "content": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "operacion": "registro",
        "codigoSucursal": 0,
        "codigoPuntoVenta": 0,
        "gestion": 2026,
        "periodo": 8,
        "cantidadFacturas": 1,
        "hashArchivo": "ec85c44e4f9d72d4c7d78c839af85e6563d43ad8ee56a231cbeaa8c5354735c8",
        "codigoRecepcion": "00000000-0000-4000-8000-000000000001",
        "codigoEstado": 908,
        "estado": "aceptado",
        "fechaEnvio": "2026-08-30T16:10:00-04:00",
        "creadoEn": "2026-08-30T16:10:00-04:00",
        "actualizadoEn": "2026-08-30T16:10:01-04:00"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Recepción de compras