Consultar producto

GET /api/v1/productos/{codigo}

Consulta un producto del catálogo por su codigo — el mismo que se utiliza para el upsert y para codigoProducto al facturar.

Autenticación y permisos

Ejemplo

curl https://api.pos.lxsyscr.com/api/v1/productos/API-TEST-001 \
  -H "X-Api-Key: $LXS_API_KEY"

Respuestas

200 OK

{
  "idProducto": 919,
  "codigo": "API-TEST-001",
  "nombre": "Producto de prueba API",
  "descripcion": "Alta desde la API de integradores",
  "codigoCabys": "2342002000000",
  "unidadMedida": "Unid",
  "precioVenta": 1500.0000,
  "precioCosto": 1000.0000,
  "idCategoria": null,
  "idSubcategoria": null,
  "idMarca": 0,
  "idProveedor": 0,
  "estado": true,
  "impuestos": [
    { "codigo": "01", "porcentaje": 13.0000, "codigoTarifa": "08" }
  ],
  "advertencia": null
}

advertencia siempre viaja en null en la consulta: solo se llena como respuesta directa de un POST que activó la autocorrección de unidad de medida. No queda persistida, por lo que releer el producto nunca la vuelve a mostrar.

404 Not Found

{ "error": "No existe un producto con código 'API-TEST-001'." }

Notas operativas

• La consulta no filtra por estado: un producto desactivado (estado: false) se devuelve de igual forma. Debe verificarse ese campo si se requiere distinguirlo.
• El codigo se compara tal cual contra lo guardado, sin normalizar mayúsculas y minúsculas; lo único que se hace es recortar espacios al inicio y al final del valor recibido.