Handy soporte la integración para enviar los eventos como pedidos, visitas con o sin formulario y nuevos clientes a través de mensajes vía AWS SQS, de esta manera podemos obtener todos los beneficios de la tecnología SQS y no perder ningún mensaje, gracias a los mecanismos de reintento de SQS.

Para activar el uso, comparte con nosotros tu número de cuenta de AWS a hola@handy.la o en el chat, y te daremos acceso a una cola de SQS sobre la cuál podrás leer los mensajes de eventos utilizando el lenguaje de programación que prefieras (C#, Java, JavaScript, etc.)

No es necesario pagar por el servicio de AWS, pues cae dentro del plan gratuito de uso de AWS.


Los mensajes tendrán la siguiente estructura:

  • Un atributo llamado "type" que indicará que tipo de información tiene el mensaje. Pueden ser "visit", "new-customer", "sales-order".
  • El mensaje a leer será tipo String y vendrá estructurado formato JSON. Para manejar la información deberás convertir el String en formato JSON.

Ejemplos de mensajes:

Atributo type: visit

Mensaje en tipo String:

{
"id": 450146,
"createdBy": "angel.y@handy.la",
"result": {
"id": 1,
"description": "Venta registrada",
"enabled": true,
"effective": true,
"formGroupVersion": 0
},
"dateCreated": 1477334642372,
"start": "2016-10-24T18:43:46Z",
"end": "2016-10-24T18:44:00Z",
"latitude": 20.66704750061035,
"longitude": -103.43767547607422,
"accuracy": 50,
"comment": "11-8",
"geofenceExit": null,
"formResponse": null,
"calendarEvent": null,
"customer": {
"id": 2205231,
"code": "2205231",
"description": "Cliente Enrique",
"enabled": true,
"latitude": 20.6670329,
"longitude": -103.4377228,
"accuracy": 21.355,
"zone_id": 5253,
"zone_description": "Zona 1",
"address": "Calle Santo Tomas de Aquino 5748 ",
"city": "Zapopan",
"postal_code": "",
"owner": "",
"phone_number": "",
"comments": "",
"date_created": 1475864430000,
"last_updated": 1475864430000,
"is_prospect": true,
"mobile": false,
"email": "",
"priceList": null,
"discount": 0,
"created_by": "temo@handy.la",
"balance": 0,
"credit": 0,
"customerFather": 0
}
}

Atributo type: sales-order

Mensaje en tipo String:

{
"id": 204674,
"items": [
{
"id": 958799,
"product_code": "P002",
"product_id": 1081464,
"price": 12,
"quantity": 4,
"comments": null
},
{
"id": 958800,
"product_code": "P001",
"product_id": 1081463,
"price": 12.5,
"quantity": 3,
"comments": null
},
{
"id": 958801,
"product_code": "P003",
"product_id": 1081465,
"price": 9.5,
"quantity": 2,
"comments": null
}
],
"customer_code": "2205232",
"customer_id": 2205232,
"type": null,
"delivery_scheduled_date": null,
"created_by": {
"username": "angel.y@handy.la",
"name": "Angel Yolando"
},
"comment": null,
"date_created": 1477334713675,
"total": 104.5,
"price_list": null
}

Atributo type: new-customer

Mensaje en tipo String:

{
"id": 2205268,
"code": "2205268",
"description": "Cliente X",
"enabled": true,
"latitude": 20.6670475,
"longitude": -103.4376756,
"accuracy": 50,
"zone_id": 5253,
"zone_description": "Zona 1",
"address": "Calle Santo Tomas de Aquino 5748 ",
"city": "Zapopan",
"postal_code": "",
"owner": "",
"phone_number": "364525407961",
"comments": "",
"date_created": 1477335119548,
"last_updated": 1477335119548,
"is_prospect": true,
"mobile": false,
"email": "",
"priceList": null,
"discount": 0,
"created_by": "angel.y@handy.la",
"balance": 0,
"credit": 0,
"customerFather": 0
}

¿Encontró su respuesta?