Consultar | Credonix

Descripción general

Este endpoint devuelve un producto de tu organización con su categoría y sus impuestos. Si el id no existe o pertenece a otra organización, la API responde 404.

Requiere el permiso Leer en Productos.

Endpoint

GEThttps://app.credonix.mx/api/v1/products/{productId}

Path param: productId — el id del producto.

Consulta un producto

Devuelve el producto completo. Un producto sin categoría llega con category: null y uno sin impuestos con taxes: [].

Campos de la respuesta

Campo	Tipo	Descripción
`id`	string	Identificador del producto.
`name`	string	Nombre del producto/servicio.
`description`	string \| null	Descripción.
`unit_price`	string \| null	Precio unitario, sin decimales fijos (`"1234.5"`, `"10.25"`). `null` si no tiene precio.
`code`	string \| null	Código producto y/o servicio.
`unit_code`	string \| null	Unidad de medida.
`tariff_code`	string \| null	Código de tarifa.
`customs_unit`	string \| null	Unidad de medida aduanera.
`category`	objeto \| null	Categoría interna, con `id` y `name`. `null` si el producto no tiene categoría.
`taxes`	array	Impuestos del producto. Ver abajo.
`created_at`	string	Fecha de creación, ISO 8601.
`updated_at`	string	Fecha de la última modificación, ISO 8601.

Los campos de texto sin valor llegan en null en un producto recién creado y como "" después de editarlo.

`taxes`

Campo	Tipo	Descripción
`type`	string	`iva`, `isr` o `ieps`.
`category`	string	`transferred` (trasladado), `withheld` (retenido) o `exempt` (exento).
`percentage`	string	Porcentaje del impuesto en puntos porcentuales: `"16"` es 16 %.

Errores

Status	Código	Causa
`401`	`MISSING_API_KEY`, `INVALID_API_KEY`, `API_KEY_REVOKED`	API key ausente, inválida o revocada.
`403`	`INSUFFICIENT_PERMISSIONS`	La API key no tiene el permiso Leer en Productos.
`404`	`NOT_FOUND`	El producto no existe en tu organización. La respuesta incluye `"message": "Producto no encontrado."`.