Proveedores | API de facturación electrónica

Catálogo de proveedores. Se usa principalmente como referencia (provider_entity_id) al emitir Liquidaciones de Compra (tipo 03).

GET/providers API Key

Lista proveedores 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, identification, businessName, email, cellphone, address, createdAt. Por defecto businessName asc.
sortDir	string	No	Sentido del ordenamiento: asc o desc.
search	string	No	Búsqueda parcial sobre identificación, razón social y correo.
identificationTypeId	int	No	Filtra por tipo de identificación.
ids	string	No	Lista de IDs separados por coma. Devuelve únicamente esos registros.

GET/providers/{id} API Key

Obtiene un proveedor por su ID.

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

GET/providers/search/{identification} API Key

Busca un proveedor por número de identificación.

POST/providers API Key

Crea un nuevo proveedor.

Campo	Tipo	Requerido	Descripción
businessId	int	Sí	ID del negocio.
identificationTypeId	int	Sí	Tipo de identificación (ver /catalogs/identification-types).
identification	string(20)	Sí	Número de identificación.
businessName	string(200)	Sí	Razón social o nombre.
address	string	No	Dirección.
phoneNumber	string(20)	No	Teléfono fijo.
phoneExtension	string(10)	No	Extensión telefónica.
cellphone	string(20)	No	Celular.
email	string	No	Correo electrónico.

json

{
  "businessId": 1,
  "identificationTypeId": 1,
  "identification": "0105678901",
  "businessName": "Proveedor S.A.",
  "address": "Av. Principal 123, Quito",
  "cellphone": "0991234567",
  "email": "ventas@proveedor.com"
}

PUT/providers/{id} API Key

Actualiza un proveedor existente.

json

{
  "businessName": "Proveedor Andino S.A.",
  "email": "facturacion@proveedor.com"
}

DELETE/providers/{id} API Key

Elimina (soft-delete) un proveedor.

json

{ "businessId": 1 }