Productos / Servicios | API de facturación electrónica

Los items son los productos o servicios que se facturan. Cada item pertenece a un negocio, tiene un tipo (producto vs. servicio) y un impuesto por defecto. Al emitir un comprobante, se referencian por item_id.

GET/items API Key

Lista los productos/servicios de un negocio.

Colección paginada: sin page ni perPage recibes la primera página de 25 registros y el bloque meta. Ver Paginación y filtros.

Campo	Tipo	Requerido	Descripción
businessId	int	Sí	ID del negocio.
page	int	No	Número de página. Por defecto 1.
perPage	int	No	Tamaño de página. Por defecto 25, máximo 100. Alias: limit.
sortBy	string	No	Campo de ordenamiento. Valores admitidos: id, code, auxCode, name, unitPrice, itemType, tax, createdAt. Por defecto name asc.
sortDir	string	No	Sentido del ordenamiento: asc o desc.
search	string	No	Búsqueda parcial sobre nombre, código y código auxiliar.
itemTypeId	int	No	Filtra por tipo de producto/servicio.
ids	string	No	Lista de IDs separados por coma. Devuelve únicamente esos registros.

GET/items/{id} API Key

Obtiene un producto por su ID.

Campo	Tipo	Requerido	Descripción
businessId	int	Sí	ID del negocio.

POST/items API Key

Crea un nuevo producto o servicio.

Campo	Tipo	Requerido	Descripción
businessId	int	Sí	ID del negocio.
itemTypeId	int	Sí	Tipo de item (ver /catalogs/item-types).
taxId	int	No	ID del impuesto a aplicar por defecto.
name	string(50)	Sí	Nombre del producto o servicio.
defaultTax	bool	Sí	Si se debe aplicar el impuesto por defecto al facturar.
code	string(10)	Sí	Código principal interno del item.
auxCode	string(10)	Sí	Código auxiliar (puede ser código de barras o similar).
unitPrice	float	Sí	Precio unitario sin impuestos.

json

{
  "businessId": 1,
  "itemTypeId": 1,
  "taxId": 1,
  "name": "Servicio de Consultoría",
  "defaultTax": true,
  "code": "SRV001",
  "auxCode": "AUX001",
  "unitPrice": 150.00
}

PUT/items/{id} API Key

Actualiza un producto existente.

json

{
  "name": "Servicio de Auditoría",
  "unitPrice": 200.00
}

DELETE/items/{id} API Key

Elimina (soft-delete) un producto.