La API v2 de Handy te permite interactuar con nuestro sistema de manera programática.
Los recursos de uso más frecuente, están marcados con una estrella (⭐).
Las siguientes guías te pueden servir durante el proceso de integración:
Pedidos ⭐️en Acciones primarias
Obtener un pedido
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador del pedido.
- GEThttps://hub.handy.la/api/v2/salesOrder/id
(Cargando)
(Cargando)
Obtener un pedido por ID externo
Obtener un pedido usando el ID externo, no el de Handy (externalId). Útil para integraciones.
Puedes establecer el ID de pedido externo usando un PUT a /salesOrder/{id}.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador externo del pedido.
- GEThttps://hub.handy.la/api/v2/salesOrder/external/id
(Cargando)
(Cargando)
Lista de pedidos
Enlista todos los pedidos
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss
Fecha fin dd/MM/aaaa HH:mm:ss
Página a regresar. Default: 1
Máximo de registros, topado a 100 por página. Default: 10
Cualquier campo del modelo. Default: dateCreated
asc o desc. Default: asc. 🔴 Sólo se puede utilizar este ordenamiento personalizado en combinación con el campo sort. Si sólo se especifica order, no tendrá ningún efecto.
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
PRESALE, ROUTESALE, ó RETURNSALE.
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated. 🔴 En la mayoría de los casos de uso, se recomienda mejor utilizar el campo dateCreated, que representa el timestamp de llegada al servidor, y no de la captura en el celular. De esta manera, se evita perder pedidos entre pollings si se captura un pedido en modo offline.
- GEThttps://hub.handy.la/api/v2/salesOrder
(Cargando)
(Cargando)
Crear pedido
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Fecha de creación en móvil dd/MM/aaaa HH:mm:ss.
Arreglo de items
Código de producto
Cantidad
Precio
Total
Comentarios
Precio original
Descuento
Cantidad entregada
IDs de promociones
Nombres de promociones
Código de cliente
Ha sido exportado
Latitud
Precisión
Ventas totales
Tipo
Indica si el cliente requiere factura. true ò false.
Comentario del vendedor
Código del precio de lista
Ha sido facturado
Ha sido capturado en ubicación del cliente
Solo en venta en ruta CASH o CREDIT
Fecha programada para entrega
Longitud
- POSThttps://hub.handy.la/api/v2/salesOrder
(Cargando)
(Cargando)
Actualizar pedido
Solo se pueden actualizar el atributo externalId y errorMessageFromIntegration
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador del pedido.
Identificador externo
Mensaje de error de la integración
- PUThttps://hub.handy.la/api/v2/salesOrder/id
(Cargando)
(Cargando)
Eliminar pedido
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador del pedido.
- DELETEhttps://hub.handy.la/api/v2/salesOrder/id
(Cargando)
(Cargando)
Marcar como facturado
Marcar un pedido como facturado.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador del pedido.
- PATCHhttps://hub.handy.la/api/v2/salesOrder/salesOrderId/markAsBilled
(Cargando)
(Cargando)
Marcar como exportado
Marcar un pedido como exportado.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador del pedido.
- PATCHhttps://hub.handy.la/api/v2/salesOrder/salesOrderId/markAsExported
(Cargando)
(Cargando)
Pedidos del cliente
Enlista todos los pedidos de un cliente.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
código del cliente.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
- GEThttps://hub.handy.la/api/v2/customer/customerCode/salesOrder
(Cargando)
(Cargando)
Pedidos de la lista de precios
Enlista todos los pedidos de una lista de precios.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
código de la lista de precios.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
- GEThttps://hub.handy.la/api/v2/priceList/priceListCode/salesOrder
(Cargando)
(Cargando)
Pedidos del usuario
Enlista todos los pedidos de un usuario.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador de usuario
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
- GEThttps://hub.handy.la/api/v2/user/userId/salesOrder
(Cargando)
(Cargando)
Rutas ⭐️en Acciones primarias
Lista de rutas
Enlista todas las rutas
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true para solo mostrar rutas cerradas o false solo para mostrar rutas abiertas,
si requieres ambas no incluyas este parámetro.
Fecha a usar para filtrar mobileDateCreated, dateCreated, lastUpdated, dateFinishedByUser,
también puedes usar dateClosed y solo obtendrás rutas cerradas. Default: mobileDateCreated
Hace que la respuesta traiga los IDs de los pedidos (campo salesOrders) y entregas (campo deliveries) que pertenecen a la ruta. Puede ser true ó false. Default false.
Hace que la respuesta filtre los pedidos hayan sido eliminados (campo salesOrders) que pertenecen a la ruta. Puede ser true ó false. Y tiene que estar la variable includeSalesOrders como true para que se muestren los pedidos. Default true.
- GEThttps://hub.handy.la/api/v2/user/userId/route
(Cargando)
(Cargando)
Obtener una ruta
Identificador de la ruta.
- GEThttps://hub.handy.la/api/v2/route/id
(Cargando)
(Cargando)
Crear ruta
Hemos agregado el parámetro - prettyMessages, este parámetro es usado para regresar un mensaje claro sobre el artículo que tiene errores.
Revisa las respuestas 422 la primera no ha enviado el parámetro prettyMessages en su solicitud, la segunda sí.
Identificador de usuario.
Incluye el código del artículo con el error y un mensaje claro.
true o false. Default: false
Lista de pedidos
Identificador de pedido
Lista de artículos
Cantidad
Identificador del artículo del pedido
Lista de productos
Código de producto
Cantidad
Fecha de entrega
Comentarios
Monto inicial
- POSThttps://hub.handy.la/api/v2/user/userId/route
(Cargando)
(Cargando)
Rutas de usuario
Enlista las rutas de un usuario en específico.
Identificador de usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/route
(Cargando)
(Cargando)
Ruta abierta actual de usuario
Obtiene la ruta abierta actual de un usuario en específico.
Identificador de usuario.
- GEThttps://hub.handy.la/api/v2/user/userId/route/current
(Cargando)
(Cargando)
Recargar ruta
Hemos agregado el parámetro - prettyMessages, este parámetro es usado para regresar un mensaje claro sobre el artículo que tiene errores.
Revisa las respuestas 422 la primera no ha enviado el parámetro prettyMessages en su solicitud, la segunda sí.
Identificador de usuario.
Incluye el código del artículo con el error y un mensaje claro.
true o false. Default: false
Lista de artículos
Código de producto
Cantidad
- POSThttps://hub.handy.la/api/v2/user/userId/route/recharge
(Cargando)
(Cargando)
Lista de pedidos disponibles
Enlista todos los pedidos disponibles para crear una ruta
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador de usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hace 1 año
Fecha fin dd/MM/aaaa HH:mm:ss. Default: dentro de 1 año
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
- GEThttps://hub.handy.la/api/v2/user/userId/route/salesOrders
(Cargando)
(Cargando)
Lista de entregas asignadas al usuario
Enlista todos las entregas asignadas al usuario dadas las fechas
Identificador de usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
- GEThttps://hub.handy.la/api/v2/user/userId/deliveries
(Cargando)
(Cargando)
Clientesen Acciones primarias
Crear cliente
Código.
Descripción.
Identificador de zona
Nombre de la persona que atiende con el cliente. No es el vendedor.
Es prospecto true ò false.
Dirección.
Comentarios (tamaño límite 2000 caracteres).
Ciudad.
Latitud.
Código postal.
Descuento.
Indica si el cliente requiere factura. true ò false.
Arreglo de fotos de cliente, dadas de alta desde la app móvil.
Identificador de precio de lista.
Número telefónico.
Saldo pendiente.
Es cliente móvil.
Colonia.
Identificador de categoría.
Límite de crédito.
Correo electrónico.
Longitud.
Valor que identifica el regimen fiscal del SAT en Facturama.
Por ejemplo 603 para referirse a Personas Morales con Fines no Lucrativos.
Podrás consultar todos los valores de los regimes fiscales en este endpoint.
Valor que identifica el uso de CFDI del SAT en Facturama.
Por ejemplo G03 para referirse a Gastos en general.
Podrás consultar todos los valores de los usos de CFDI en este endpoint.
Identificador externo. Útil para integraciones con otros sistemas.
- POSThttps://hub.handy.la/api/v2/customer
(Cargando)
(Cargando)
Lista de clientes
Enlista todos los clientes
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Filtra a los clientes prospetos. true ò false.
Filtra a los clientes que requieren factura. true ò false.
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
Filtra clientes por una exacta coincidencia con su descripción.
- GEThttps://hub.handy.la/api/v2/customer
(Cargando)
(Cargando)
Obtener un cliente
Código del cliente.
- GEThttps://hub.handy.la/api/v2/customer/customerCode
(Cargando)
(Cargando)
Obtener un cliente por ID externo
Obtener un cliente usando el ID externo, no el de Handy (externalId). Útil para integraciones.
Puedes establecer el ID de cliente externo usando un PUT a /customer/{id}.
Identificador externo del cliente.
- GEThttps://hub.handy.la/api/v2/customer/external/id
(Cargando)
(Cargando)
Actualizar cliente
Código del cliente.
Código.
Descripción.
Identificador de zona
Nombre de la persona que atiende con el cliente. No es el vendedor.
Es prospecto true ò false.
Dirección.
Comentarios (tamaño límite 2000 caracteres).
Ciudad.
Latitud.
Código postal.
Descuento.
Indica si el cliente requiere factura. true ò false.
Arreglo de fotos de cliente, dadas de alta desde la app móvil.
Identificador de precio de lista.
Número telefónico.
Saldo pendiente.
Es cliente móvil.
Colonia.
Identificador de categoría.
Límite de crédito.
Correo electrónico.
Longitud.
Valor que identifica el regimen fiscal del SAT en Facturama.
Por ejemplo 603 para referirse a Personas Morales con Fines no Lucrativos.
Podrás consultar todos los valores de los regimes fiscales en este endpoint.
Valor que identifica el uso de CFDI del SAT en Facturama.
Por ejemplo G03 para referirse a Gastos en general.
Podrás consultar todos los valores de los usos de CFDI en este endpoint.
Identificador externo. Útil para integraciones con otros sistemas.
- PUThttps://hub.handy.la/api/v2/customer/customerCode
(Cargando)
(Cargando)
Eliminar cliente
Código del cliente.
- DELETEhttps://hub.handy.la/api/v2/customer/customerCode
(Cargando)
(Cargando)
Lista de pedidos del cliente
Enlista todos los pedidos de un cliente.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
código del cliente.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
- GEThttps://hub.handy.la/api/v2/customer/customerCode/salesOrder
(Cargando)
(Cargando)
Precios acordados de un cliente en específico
Enlista todos los precios acordados de un cliente en específico.
Código del cliente.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/productCustomer
(Cargando)
(Cargando)
Visitas programadas de un cliente
Enlista todos los pedidos de un cliente.
código del cliente.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/calendarEvent
(Cargando)
(Cargando)
Respuestas a formularios de un cliente
Enlista todos las respuestas a formularios de un cliente.
código del cliente.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/formResponse
(Cargando)
(Cargando)
Lista de pagos de un cliente
Enlista todos los pagos de un cliente.
código del cliente.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/paymentLog
(Cargando)
(Cargando)
Lista de visitas de un cliente
Enlista todas las visitas de un cliente.
código del cliente.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/visit
(Cargando)
(Cargando)
Productosen Acciones primarias
Crear producto
Código.
Descripción.
Precio.
Identificador de familia.
Cantidad.
Promover las ventas de este producto. true o false
Descripción para promover las ventas de este producto.
Identificador de categoría.
Código de producto o servicio del SAT, revisar endpoint de productos del SAT.
Unidad de medida del SAT, revisar endpoint de unidades de medida.
Identificador del impuesto, revisar endpoint de lista de impuestos.
Identificador del impuesto opcional, revisar endpoint de lista de impuestos.
- POSThttps://hub.handy.la/api/v2/product
(Cargando)
(Cargando)
Lista de productos
Enlista todos los productos
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
Filtra productos por una exacta coincidencia con su descripción.
- GEThttps://hub.handy.la/api/v2/product
(Cargando)
(Cargando)
Obtener un producto
Código del producto.
- GEThttps://hub.handy.la/api/v2/product/productCode
(Cargando)
(Cargando)
Obtener un producto con caracteres especiales en código
Código de producto con caracteres especiales a enviar en el cuerpo del GET.
- GEThttps://hub.handy.la/api/v2/productByCode
(Cargando)
(Cargando)
Actualizar producto
Código del producto.
Código.
Cantidad.
Promover las ventas de este producto. true o false
Precio.
Descripción.
Descripción para promover las ventas de este producto.
Identificador de categoría.
Identificador de familia.
Código de producto o servicio del SAT, revisar endpoint de productos del SAT.
Unidad de medida del SAT, revisar endpoint de unidades de medida.
Identificador del impuesto, revisar endpoint de lista de impuestos.
Identificador del impuesto opcional, revisar endpoint de lista de impuestos.
- PUThttps://hub.handy.la/api/v2/product/productCode
(Cargando)
(Cargando)
Actualizar producto con caracteres especiales en código
Código.
Código nuevo. Si se quiere actualizar el campo de código: este es el valor que tomará.
Cantidad.
Promover las ventas de este producto. true o false
Precio.
Descripción.
Descripción para promover las ventas de este producto.
Identificador de categoría.
Identificador de familia.
Código de producto o servicio del SAT, revisar endpoint de productos del SAT.
Unidad de medida del SAT, revisar endpoint de unidades de medida.
Identificador del impuesto, revisar endpoint de lista de impuestos.
Identificador del impuesto opcional, revisar endpoint de lista de impuestos.
- PUThttps://hub.handy.la/api/v2/productByCodeUpdate
(Cargando)
(Cargando)
Eliminar producto
Código del producto.
- DELETEhttps://hub.handy.la/api/v2/product/productCode
(Cargando)
(Cargando)
Precios acordados por cliente de un producto en específico
Enlista todos los precios acordados por cliente de un producto en específico.
Código del producto.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/product/productCode/productCustomer
(Cargando)
(Cargando)
Listas de precios ⭐️en Acciones primarias
Crear lista de precios
Hemos agregado el parámetro - prettyMessages, este parámetro es usado para regresar un mensaje claro sobre el artículo que tiene errores.
Revisa las respuestas 422 la primera no ha enviado el parámetro prettyMessages en su solicitud, la segunda sí.
Incluye el código del artículo con el error y un mensaje claro.
true o false. Default: false
Código (tamaño límite 50 caracteres).
nombre de lista.
Lista de artículos
Código de producto
Precio
- POSThttps://hub.handy.la/api/v2/priceList
(Cargando)
(Cargando)
Enlistar lista de precios
Enlista todas las listas de precios
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
true o false. Default: true
- GEThttps://hub.handy.la/api/v2/priceList
(Cargando)
(Cargando)
Obtener un precio de lista
Código de la lista de precios.
- GEThttps://hub.handy.la/api/v2/priceList/priceListCode
(Cargando)
(Cargando)
Actualizar lista de precios
Hemos agregado el parámetro - prettyMessages, este parámetro es usado para regresar un mensaje claro sobre el artículo que tiene errores.
Revisa las respuestas 422 la primera no ha enviado el parámetro prettyMessages en su solicitud, la segunda sí.
Código de la lista de precios (tamaño límite 50 caracteres).
Incluye el código del artículo con el error y un mensaje claro.
true o false. Default: false
Código.
nombre de lista.
Lista de artículos
Código de producto
Precio
- PUThttps://hub.handy.la/api/v2/priceList/priceListCode
(Cargando)
(Cargando)
Eliminar lista de precios
Código de la lista de precios.
- DELETEhttps://hub.handy.la/api/v2/priceList/priceListCode
(Cargando)
(Cargando)
Lista de pedidos de la lista de precios
Enlista todos los pedidos de una lista de precios.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
código de la lista de precios.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
- GEThttps://hub.handy.la/api/v2/priceList/priceListCode/salesOrder
(Cargando)
(Cargando)
Precios por clienteen Acciones primarias
Crear precios acordados por cliente
Código de producto.
Precio.
Código de cliente.
- POSThttps://hub.handy.la/api/v2/productCustomer
(Cargando)
(Cargando)
Lista precios acordados por cliente
Enlista todos los precios de productos acordados por cliente
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
true o false. Default: true
- GEThttps://hub.handy.la/api/v2/productCustomer
(Cargando)
(Cargando)
Deshabilitar precios acordados por cliente
Deshabilita precios acordados por cliente
Código de producto.
Código de cliente.
- DELETEhttps://hub.handy.la/api/v2/productCustomer
(Cargando)
(Cargando)
Precios acordados de un cliente en específico
Enlista todos los precios acordados de un cliente en específico.
Código del cliente.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/productCustomer
(Cargando)
(Cargando)
Precios acordados por cliente de un producto en específico
Enlista todos los precios acordados por cliente de un producto en específico.
Código del producto.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/product/productCode/productCustomer
(Cargando)
(Cargando)
Usuariosen Acciones primarias
Crear usuario
Identificador de rol.
Contraseña (tamaño límite 128 caracteres).
Identificador de Zona.
Nombre.
Correo electrónico.
Comentarios.
Zona horaria.
Latitud.
Url de foto.
Extras.
Lugar del usuario.
Código telefónico del pais del usuario.
Número telefónico.
Si desea enviar el resumen de cumplimiento de precios.
Identificador del tipo de usuario.
Longitud.
Nombre de usuario.
- POSThttps://hub.handy.la/api/v2/user
(Cargando)
(Cargando)
Lista de usuarios
Enlista todos los usuarios
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Identificador de role.
Identificador de tipo de usuario.
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
- GEThttps://hub.handy.la/api/v2/user
(Cargando)
(Cargando)
Obtener un usuario
Identificador del usuario.
- GEThttps://hub.handy.la/api/v2/user/id
(Cargando)
(Cargando)
Actualizar usuario
Identificador del usuario.
Identificador de rol.
Contraseña (tamaño límite 128 caracteres).
Identificador de Zona.
Nombre.
Correo electrónico.
Comentarios.
Zona horaria.
Latitud.
Url de foto.
Extras.
Lugar del usuario.
Código telefónico del pais del usuario.
Número telefónico.
Si desea enviar el resumen de cumplimiento de precios.
Identificador del tipo de usuario.
Longitud.
Nombre de usuario.
- PUThttps://hub.handy.la/api/v2/user/id
(Cargando)
(Cargando)
Deshabilitar usuario
Deshabilita usuario
Identificador del usuario.
- DELETEhttps://hub.handy.la/api/v2/user/id
(Cargando)
(Cargando)
Pedidos disponibles de un repartidor
Muestra los pedidos disponibles para una ruta de entrega abierta de un repartidor
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
- GEThttps://hub.handy.la/api/v2/user/userId/deliverySalesOrders
(Cargando)
(Cargando)
Buscar un usuario
Busca un usuario con su nombre de usuario (Correo electrónico).
Correo electrónico del usuario.
- GEThttps://hub.handy.la/api/v2/user/search?username
(Cargando)
(Cargando)
Lista de pedidos de un usuario
Enlista todos los pedidos de un usuario.
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador de usuario
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
true o false.
Indica si el cliente requiere factura. true ò false.
true o false.
- GEThttps://hub.handy.la/api/v2/user/userId/salesOrder
(Cargando)
(Cargando)
Crear ruta
Hemos agregado el parámetro - prettyMessages, este parámetro es usado para regresar un mensaje claro sobre el artículo que tiene errores.
Revisa las respuestas 422 la primera no ha enviado el parámetro prettyMessages en su solicitud, la segunda sí.
Identificador de usuario.
Incluye el código del artículo con el error y un mensaje claro.
true o false. Default: false
Lista de pedidos
Identificador de pedido
Lista de artículos
Cantidad
Identificador del artículo del pedido
Lista de productos
Código de producto
Cantidad
Fecha de entrega
Comentarios
Monto inicial
- POSThttps://hub.handy.la/api/v2/user/userId/route
(Cargando)
(Cargando)
Lista de rutas
Enlista las rutas de un usuario en específico.
Identificador de usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/route
(Cargando)
(Cargando)
Ruta abierta actual
Obtiene la ruta abierta actual de un usuario en específico.
Identificador de usuario.
- GEThttps://hub.handy.la/api/v2/user/userId/route/current
(Cargando)
(Cargando)
Recargar ruta
Hemos agregado el parámetro - prettyMessages, este parámetro es usado para regresar un mensaje claro sobre el artículo que tiene errores.
Revisa las respuestas 422 la primera no ha enviado el parámetro prettyMessages en su solicitud, la segunda sí.
Identificador de usuario.
Incluye el código del artículo con el error y un mensaje claro.
true o false. Default: false
Lista de artículos
Código de producto
Cantidad
- POSThttps://hub.handy.la/api/v2/user/userId/route/recharge
(Cargando)
(Cargando)
Lista de pedidos disponibles
Enlista todos los pedidos disponibles para crear una ruta
Hemos agregado el campo a la respuesta - operativeStatus, el cual contiene los siguientes valores: PENDING_DELIVERY,ON_ROUTE,PARTIAL_DELIVERED_OPEN,PARTIAL_DELIVERED_CLOSED,DELIVERED_COMPLETE,RETURNED,CLOSED.
También hemos agregado el campo a la respuesta - prettyOperativeStatus, que nos informa del estatus operativo de una forma más clara y contiene los siguientes valores: Por entregar,En ruta,Entrega parcial,Cerrado - Entrega parcial,Entrega completa,Devuelto,Cerrado.
Revisa el siguiente link para más información: Estados operativos de pedido
Identificador de usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
- GEThttps://hub.handy.la/api/v2/user/userId/route/salesOrders
(Cargando)
(Cargando)
Lista de entregas asignadas al usuario
Enlista todos las entregas asignadas al usuario dadas las fechas
Identificador de usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
- GEThttps://hub.handy.la/api/v2/user/userId/deliveries
(Cargando)
(Cargando)
Visitas programadas de un usuario
Enlista todos los pedidos de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/calendarEvent
(Cargando)
(Cargando)
Elimina visitas programadas de un usuario
Elimina las visitas programadas en un rango de fechas de un usuario en específico.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss.
Fecha fin dd/MM/aaaa HH:mm:ss.
- DELETEhttps://hub.handy.la/api/v2/user/userId/calendarEvent
(Cargando)
(Cargando)
Respuestas a formularios de un usuario
Enlista todas las respuestas a formularios de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/formResponse
(Cargando)
(Cargando)
Lista de pagos de un usuario
Enlista todas los pagos de un usuario.
Identificador del usuario.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/paymentLog
(Cargando)
(Cargando)
Lista de visitas de un usuario
Enlista todas las visitas de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/visit
(Cargando)
(Cargando)
Visitas programadasen Acciones primarias
Programar visita
Fecha de termino dd/MM/aaaa HH:mm:ss.
Fecha de inicio dd/MM/aaaa HH:mm:ss.
Identificador de usuario.
Código de cliente.
Recurrencia.
Comentario.
Pronostico de venta.
- POSThttps://hub.handy.la/api/v2/calendarEvent
(Cargando)
(Cargando)
Lista de visitas programadas
Enlista todas las visitas programadas.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
- GEThttps://hub.handy.la/api/v2/calendarEvent
(Cargando)
(Cargando)
Elimina visitas programadas
Elimina las visitas programadas de un rango de fechas.
Fecha inicio dd/MM/aaaa HH:mm:ss.
Fecha fin dd/MM/aaaa HH:mm:ss.
- DELETEhttps://hub.handy.la/api/v2/calendarEvent
(Cargando)
(Cargando)
Obtener una visita programada
Identificador de la visita.
- GEThttps://hub.handy.la/api/v2/calendarEvent/id
(Cargando)
(Cargando)
Visitas programadas de un cliente
Enlista todos los pedidos de un cliente.
código del cliente.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/calendarEvent
(Cargando)
(Cargando)
Visitas programadas de un usuario
Enlista todos los pedidos de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/calendarEvent
(Cargando)
(Cargando)
Elimina visitas programadas de un usuario
Elimina las visitas programadas en un rango de fechas de un usuario en específico.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss.
Fecha fin dd/MM/aaaa HH:mm:ss.
- DELETEhttps://hub.handy.la/api/v2/user/userId/calendarEvent
(Cargando)
(Cargando)
Respuestas a formulariosen Acciones primarias
Lista de respuestas a formularios
Enlista todas las respuestas a formularios.
El error 404 se puede presentar si se filtra por un usuario, cliente o formulario que no existen. Los filtros por usuario, cliente o formulario, estás optimizados para utilizarse de forma independiente (no combinados).
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
ID de formulario para filtrar. Ejemplo /formResponse?formId=1
Fecha a usar para filtrar dateAnswered, dateCreated . Default: dateAnswered. Para estar haciendo polling de las respuestas usar dateCreated.
- GEThttps://hub.handy.la/api/v2/formResponse
(Cargando)
(Cargando)
Obtener una respuesta a formulario
Identificador de la respuesta a formulario.
- GEThttps://hub.handy.la/api/v2/formResponse/id
(Cargando)
(Cargando)
Respuestas a formularios de un cliente
Enlista todos las respuestas a formularios de un cliente.
código del cliente.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/formResponse
(Cargando)
(Cargando)
Respuestas a formularios de un usuario
Enlista todas las respuestas a formularios de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/formResponse
(Cargando)
(Cargando)
Ubicación de usuariosen Acciones primarias
Historial de ubicaciones
Enlista todas las ubicaciones de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
- GEThttps://hub.handy.la/api/v2/user/userId/locationHistory
(Cargando)
(Cargando)
Notificacionesen Acciones primarias
Enviar una notificación
Identificador de pedido.
Mensaje.
tipo.
- POSThttps://hub.handy.la/api/v2/notification/push
(Cargando)
(Cargando)
Pagosen Acciones primarias
Lista de pagos
Enlista todos los pagos.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Fecha a usar para filtrar mobileDateCreated, dateCreated o dateDeleted. Default: mobileDateCreated
- GEThttps://hub.handy.la/api/v2/paymentLog
(Cargando)
(Cargando)
Obtener un pago
Identificador del pago.
- GEThttps://hub.handy.la/api/v2/paymentLog/id
(Cargando)
(Cargando)
Lista de pagos de un cliente
Enlista todos los pagos de un cliente.
código del cliente.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/paymentLog
(Cargando)
(Cargando)
Lista de pagos de un usuario
Enlista todas los pagos de un usuario.
Identificador del usuario.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/paymentLog
(Cargando)
(Cargando)
Metas de ventasen Acciones primarias
Crear meta de venta
Monto de meta.
Periodicidad.
Identificador de usuario.
Fecha de inicio. yyyy-MM-dd
- POSThttps://hub.handy.la/api/v2/salesGoal
(Cargando)
(Cargando)
Lista de metas de venta
Enlista todas las metas de venta.
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/salesGoal
(Cargando)
(Cargando)
Obtener una meta de venta
Identificador de meta.
- GEThttps://hub.handy.la/api/v2/salesGoal/id
(Cargando)
(Cargando)
Actualizar meta de venta
Identificador de la meta.
Monto de meta.
Periodicidad.
Identificador de usuario.
Fecha de inicio. yyyy-MM-dd
- PUThttps://hub.handy.la/api/v2/salesGoal/id
(Cargando)
(Cargando)
Elimina meta de venta
Elimina meta de venta
Identificador de meta de venta.
- DELETEhttps://hub.handy.la/api/v2/salesGoal/id
(Cargando)
(Cargando)
Visitasen Acciones primarias
Crear una visita
Identificador del resultado de la visita.
Identificador del usuario.
Fecha de inicio dd/MM/aaaa HH:mm:ss.
Fecha de termino dd/MM/aaaa HH:mm:ss.
Código de cliente.
Latitude.
Precisión.
Identificador de visita programada.
Comentario.
Longitud.
- POSThttps://hub.handy.la/api/v2/visit
(Cargando)
(Cargando)
Lista de visitas
Enlista todas las vistas.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy al inicio del día
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy al final del día
Página a regresar. Default: 1
Máximo de registros por página. Default: 10. Máximo 100.
asc o desc. Default: asc
Cualquier campo del modelo. Default: start
Fecha a usar para filtrar dateCreated, start o end. Default: start
- GEThttps://hub.handy.la/api/v2/visit
(Cargando)
(Cargando)
Obtener una visita
Identificador de vista.
- GEThttps://hub.handy.la/api/v2/visit/id
(Cargando)
(Cargando)
Lista de visitas de un cliente
Enlista todas las visitas de un cliente.
código del cliente.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/customer/customerCode/visit
(Cargando)
(Cargando)
Lista de visitas de un usuario
Enlista todas las visitas de un usuario.
Identificador del usuario.
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/user/userId/visit
(Cargando)
(Cargando)
Categorías de clientesen Acciones secundarias
Lista de categorías de clientes
Enlista las categorías de clientes
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/category
(Cargando)
(Cargando)
Leer una categoría de cliente
Identificador de la categoría.
- GEThttps://hub.handy.la/api/v2/category/id
(Cargando)
(Cargando)
Crear una categoría de cliente
Descripción de la categoría.
- POSThttps://hub.handy.la/api/v2/category
(Cargando)
(Cargando)
Actualizar una categoría de cliente
Actualiza una categoría que ya estaba creada
Identificador de la categoría.
Descripción de la categoría.
- PUThttps://hub.handy.la/api/v2/category/id
(Cargando)
(Cargando)
Deshabilitar categoría de cliente
Deshabilita la categoría (enabled=false, no es borrada para que se mantengan las referencias)
Identificador de la categoría.
- DELETEhttps://hub.handy.la/api/v2/category/id
(Cargando)
(Cargando)
Categorías de productosen Acciones secundarias
Lista de categorías de producto
Enlista las categorías de producto
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/productCategory
(Cargando)
(Cargando)
Leer una categoría de producto
Identificador de la categoría.
- GEThttps://hub.handy.la/api/v2/category/id
(Cargando)
(Cargando)
Crear una categoría de producto
Descripción de la categoría (tamaño límite 100 caracteres).
- POSThttps://hub.handy.la/api/v2/productCategory
(Cargando)
(Cargando)
Actualizar una categoría de producto
Actualiza una categoría de producto que ya estaba creada
Identificador de la categoría.
Descripción de la categoría (tamaño límite 100 caracteres).
- PUThttps://hub.handy.la/api/v2/productCategory/id
(Cargando)
(Cargando)
Deshabilitar una categoría de producto
Deshabilita la categoría (enabled=false, no es borrada para que se mantengan las referencias)
Identificador de la categoría.
- DELETEhttps://hub.handy.la/api/v2/productCategory/id
(Cargando)
(Cargando)
Familias de productosen Acciones secundarias
Lista de familias de producto
Enlista las familias de producto
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/productFamily
(Cargando)
(Cargando)
Leer una familia de producto
Identificador de la familia.
- GEThttps://hub.handy.la/api/v2/productFamily/id
(Cargando)
(Cargando)
Crear una familia de producto
Descripción de la familia.
- POSThttps://hub.handy.la/api/v2/productFamily
(Cargando)
(Cargando)
Actualizar una familia de producto
Actualiza una familia de producto que ya estaba creada
Identificador de la familia.
Descripción de la familia.
- PUThttps://hub.handy.la/api/v2/productFamily/id
(Cargando)
(Cargando)
Deshabilitar una familia de producto
Deshabilita la familia (enabled=false, no es borrada para que se mantengan las referencias)
Identificador de la familia.
- DELETEhttps://hub.handy.la/api/v2/productFamily/id
(Cargando)
(Cargando)
Zonasen Acciones secundarias
Asignar zona a usuario
Asignar una zona a un usuario. . Regresa la lista de zonas asignadas al usuario después de la operación . Si ya la tenía asignada, no cambia nada
Identificador de usuario
Identificador de zona
- PUThttps://hub.handy.la/api/v2/user/userId/zone/zoneId
(Cargando)
(Cargando)
Desasignar zona a usuario
Elimina la asignación de zona de un usuario. Regresa la lista de zonas asignadas al usuario después de la operación.
Identificador de usuario
Identificador de zona
- DELETEhttps://hub.handy.la/api/v2/user/userId/zone/zoneId
(Cargando)
(Cargando)
Crear zona
Crea una nueva zona
- POSThttps://hub.handy.la/api/v2/zone
(Cargando)
(Cargando)
Actualizar zona
Cambiar el nombre de una zona. Para deshabilitar, usa el verbo DELETE en lugar de PUT
Identificador de la zona.
- PUThttps://hub.handy.la/api/v2/zone/id
(Cargando)
(Cargando)
Lista de zonas
Enlista las zonas
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/zone
(Cargando)
(Cargando)
Leer una zona
Obtener los detalles de una zona.
Identificador de la zona.
- GEThttps://hub.handy.la/api/v2/zone/id
(Cargando)
(Cargando)
Deshabilitar zona
Deshabilitar una zona. Antes de deshabilitarla, debes desasignarla de los usuarios.
Identificador de la zona.
- DELETEhttps://hub.handy.la/api/v2/zone/id
(Cargando)
(Cargando)
Lista de clientes de una zona
Enlista todos los clientes de una zona
Identificador de zona.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
Filtra a los clientes prospetos. true ò false.
Filtra a los clientes que requieren factura. true ò false.
- GEThttps://hub.handy.la/api/v2/zone/zoneId/customer
(Cargando)
(Cargando)
Lista de usuarios de una zona en especifico
Enlista todos los usuarios dada una zona
Identificador de zona.
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/zone/zoneId/user
(Cargando)
(Cargando)
Tipos de pedidoen Acciones secundarias
Lista de tipos de pedido
Enlista los tipos de pedido
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/salesOrderType
(Cargando)
(Cargando)
Leer tipo de pedido
Identificador de tipo de pedido.
- GEThttps://hub.handy.la/api/v2/salesOrderType/id
(Cargando)
(Cargando)
Crear tipo de pedido
Descripción del tipo de pedido.
- POSThttps://hub.handy.la/api/v2/salesOrderType
(Cargando)
(Cargando)
Actualizar un tipo de pedido
Actualiza un tipo de pedido que ya estaba creado. Sirve para cambiar la descripción
Identificador del tipo de pedido.
Descripción del tipo de pedido.
- PUThttps://hub.handy.la/api/v2/salesOrderType/id
(Cargando)
(Cargando)
Deshabilitar un tipo de pedido
Deshabilita el tipo de pedido (enabled=false, no es borrada para que se mantengan las referencias)
Identificador de tipo de pedido.
- DELETEhttps://hub.handy.la/api/v2/salesOrderType/id
(Cargando)
(Cargando)
Sincronizaciónen Acciones secundarias
Sincronizar clientes por zona
Sirve para disparar una sincronización hacia los dispositivos móviles, basado en las zonas que hayan cambiado. Por ejemplo, si se agregan masivamente clientes a las zonas 1 y 2, se puede enviar una solicitud a este método para que todos los dispositivos a los que les corresponden esas zonas, se sincronicen en tiempo real.
- POSThttps://hub.handy.la/api/v2/sync/customers
(Cargando)
(Cargando)
Resultados de visitasen Acciones secundarias
Lista de resultados de visita
Enlista los resultados de visita
true o false. Default: true
Fecha inicio dd/MM/aaaa HH:mm:ss. Default: hoy
Fecha fin dd/MM/aaaa HH:mm:ss. Default: hoy
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: dateCreated
- GEThttps://hub.handy.la/api/v2/visitResult
(Cargando)
(Cargando)
Leer resultado de visita
Identificador de resultado de visita.
- GEThttps://hub.handy.la/api/v2/visitResult/id
(Cargando)
(Cargando)
Crear resultado de visita
Descripción de resultado de visita. Es el texto que verá el vendedor en la app
Código identificador de resultado de visita. Sirve como un identificador fijo para el resultado de visita.
Efectivo o no efectivo.
- POSThttps://hub.handy.la/api/v2/visitResult
(Cargando)
(Cargando)
Actualizar resultado de visita
Actualiza un resultado de visita que ya estaba creado. No es necesario enviar todos los atributos en el cuerpo, sólo los que se desean editar.
Identificador del resultado de la visita.
Descripción de resultado de visita. Es el texto que verá el vendedor en la app
Código identificador de resultado de visita. Sirve como un identificador fijo para el resultado de visita.
Efectivo o no efectivo.
- PUThttps://hub.handy.la/api/v2/visitResult/id
(Cargando)
(Cargando)
Deshabilitar un resultado de visita
Deshabilita resultado de visita (enabled=false, no es borrada para que se mantengan las referencias)
Identificador del resultado de visita.
- DELETEhttps://hub.handy.la/api/v2/visitResult/id
(Cargando)
(Cargando)
Facturaciónen Acciones secundarias
Lista de impuestos
Se listan los impuestos de acuerdo al país al cual pertenece la compañía del token del usuario autenticado
true o false. Default: true
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: id
- GEThttps://hub.handy.la/api/v2/tax
(Cargando)
(Cargando)
Lista de productos del SAT
Enlista los productos del SAT
Filtra productos del SAT por una coincidencia con su descripción.
true o false. Default: true
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: id
- GEThttps://hub.handy.la/api/v2/satProduct
(Cargando)
(Cargando)
Lista de unidades de medida del SAT
Enlista las unidades de medida del SAT
Filtra unidades de medida del SAT por una coincidencia con su descripción.
true o false. Default: true
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: id
- GEThttps://hub.handy.la/api/v2/satUnit
(Cargando)
(Cargando)
Lista de regimes fiscales del SAT
Enlista los regimes fiscales del SAT
Filtra los regimes fiscales del SAT por una coincidencia con su descripción.
true o false. Default: true
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: id
- GEThttps://hub.handy.la/api/v2/fiscalRegime
(Cargando)
(Cargando)
Lista de usos de CFDI
Enlista los usos de CFDI
Filtra los usos de CFDI por una coincidencia con su descripción.
true o false. Default: true
Página a regresar. Default: 1
Máximo de registros, topado a 100. Default: 10
asc o desc. Default: asc
Cualquier campo del modelo. Default: id
- GEThttps://hub.handy.la/api/v2/cfdiUse
(Cargando)
(Cargando)
Configuraciónen Acciones secundarias
Obtener configuraciones de tu compañía
En este endpoint podrás conocer como está configurada tu compañía
- GEThttps://hub.handy.la/api/v2/configurations
(Cargando)
(Cargando)