Obtener recepción de compras

GET/api/v1/compras/:recepcionCompraId

Obtiene una recepción mediante su UUID, limitada a la empresa y el ambiente de la X-API-Key. Requiere el permiso facturas.consultar.

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

Contrato de la operación

Obtiene una recepción mediante su UUID, limitada a la empresa y el ambiente de la X-API-Key. Requiere el permiso facturas.consultar.

recepcionCompraId es el UUID devuelto al registrar, confirmar o buscar recepciones. operacion distingue registro de confirmacion. La respuesta no incluye el paquete generado ni credenciales SIAT. Responde 200, 400, 401, 403 o 404.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

cURL · GET

export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export RECEPCION_COMPRA_ID='REEMPLAZA_CON_RECEPCION_COMPRA_ID'

curl --request GET \
  --url "$FALMUS_API_URL/compras/${RECEPCION_COMPRA_ID}" \
  --header "X-API-Key: $FALMUS_API_KEY"

Este ejemplo no incluye un cuerpo. Revisa el contrato para conocer los parámetros de ruta y consulta.

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "recepción de compras obtenida correctamente",
  "data": {
    "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,
    "codigoDescripcion": "VALIDADA",
    "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"
  }
}

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

Volver a Recepción de compras