Endpoint Negocios

lunes 18 de septiembre de 2023

Lista de negocios

Method: GET URI: /api/v1/negocios

Este endpoint permite obtener un listado de negocios según los parámetros de búsqueda y ordenación.

Request

Headers
- Content-Type: application/json
- token: <string>
- secret:<string>
Params
- sort_column: campo por el que ordenar. Podrá ser: id, nombre. Por defecto será id.
- sort_type: indica el si la ordenación es ascendente o descendente. Podrá ser: asc o desc. Por defecto será asc.
- paginate_by: número de registros a mostrar. El mínimo será 1 y el máximo 100. Por defecto serán 10.
- page: número de página a mostrar. Por defecto será 1.
- nombre: valor a buscar en el campo nombre. La búsqueda se hará con un contiene.
- razon_fiscal: valor a buscar en el campo razon_fiscal. La búsqueda se hará con un contiene.
- razon_social: valor a buscar en el campo razon_social. La búsqueda se hará con un contiene.
- alias: valor a buscar en el campo alias. La búsqueda se hará con un contiene.
- tipo_negocio: valor a buscar en el campo tipo de negocio. La búsqueda se hará con un contiene.

Response 1: 200: existen datos

{ "status": 200, "page": 1, "paginate_by": 10, "records": 2, "data": [ { "id": 56, "nombre": "negocio 1", "fecha_inicio": "2023-02-15", "fecha_cierre": null, "comentarios": "", "valor_comercial": "0.00", "estado": null, "comentario_perdido": null }, { "id": 58, "nombre": "negocio 2", "fecha_inicio": "2023-02-16", "fecha_cierre": "2023-02-20", "comentarios": "", "valor_comercial": "45.00", "estado": null, "comentario_perdido": null } ] }

Response 2: 200: no existen datos

{ "status": 200, "page": 1, "paginate_by": 10, "records": 0, "data": [] }

Response 3: 400: petición errónea

{ "status": 400, "error": "Error en la Petición" }

Response 4: 402: petición no autorizada

{ "status": 402, "error": "No autorizado" }

Prueba la API de tu instalación aquí

Detalle de negocio

Method: GET URI: /api/v1/negocios

Este endpoint permite obtener el detalle del negocio cuyo id coincide con el parámetro suministrado.