Últimos cambios a la API de Handy

La API de Handy es actualizada con mejoras de vez en cuando.

Hacemos todo lo posible para que sean mejoras que NO rompen integraciones ya desarrolladas. Si esto llegar a suceder, te lo haremos saber, pero es muy raro

Los cambios que pueden romper integraciones, aparecen en rojo.

Si quieres monitorear los cambios, puedes usar nuestro feed de RSS: changes.rss

January 2022
  • API v2

    Agregar Extras a usuario

    Ahora el campo personalizable de usuario llamado Extras, aparecerá donde se muestren datos de usuario en las respuestas de la API.

    Esto es útil para las integraciones porque podrías escribir un objeto JSON para hacer referencia por ejemplo para asignar almacenes a los vendedores.

  • API v2

    Asignar Zona por descripción

    Ya es posible asignar a un cliente la Zona usando nombre de la zona en lugar del ID. Le das la descripción y si existe, la toma, si no, la crea.

    Ya no es necesario hacer esto en dos pasos (crear zona y luego asignarla), aunque todavía se puede hacer así.

    Para especificar por texto en lugar de por ID, se necesita especificar la descripción como objeto:

    { "zone": { "description": "Cadena de texto" }

  • API v2

    Asignar Familia de producto por descripción

    Lo mismo de las zonas, aplica para las familias de productos.

  • API v2

    Asignar ID externo de pedido para futura referencia

    Ahora se puede actualizar un pedido sólo para agregar un dato llamado externalId, donde puedes guardar el ID del pedido que se sincronizó hacia otro sistema externo.

    Esto es útil si se borra el pedido en el futuro.

    Puedes hacer referencia al ID que corresponde al sistema externo y así hacer el borrado en el sistema externo también.

    Para hacerlo, sólo haces un PUT a /api/v2/salesOrder/:id con el body:

    { externalId: "1" }

    externalId es de tipo String.