A continuación, explicamos la configuración específica a aplicar para recibir las notificaciones de ventas a través de una interfaz API.
Ingrese a la opción «Api», presione el botón «Obtener» e introduzca un nombre de referencia para la API.
Al presionar el botón «Aceptar» se generará un Access token con el cual se podrá conectar la API con Tango Tiendas.
A partir de ese momento ya puede comenzar a utilizar Tango Tiendas manejando sus ventas desde Tango Gestión a través de la API.
Configurar parámetros de cuentas
A continuación, explicamos la configuración específica a aplicar para una cuenta de Api.
Ingrese en la opción «Api», seleccione la cuenta que desea configurar y presione «Editar». Se abrirá la pantalla para configurar la cuenta con las siguientes opciones.
Procesar órdenes a partir del día: indique la fecha a partir de la cual desea procesar notificaciones de órdenes, tenga en cuenta que solo se procesarán órdenes cuya fecha sea mayor o igual a la indicada en ese parámetro. Si desea sincronizar una orden con una fecha anterior, puede hacerlo desde Revisión de pedidos de tango tiendas seleccionando la opción ‘Solicitar’.
Recibe notificaciones: si desea recibir notificaciones, debe realizar los siguientes pasos en la configuración de la API:
- Desde la aplicación de Tango Tiendas acceda a la opción «API».
- Seleccione la cuenta en la que desea configurar las notificaciones y presione «Editar».
- Habilite la casilla de selección Recibe notificaciones e ingrese en el campo URL de notificaciones la URL donde desea recibir las notificaciones.
Tópicos a notificar indique los eventos sobre los que desea recibir notificaciones en la URL configurada. En el momento que desee dejar de recibirlas, desmárquelos.
Órdenes:
- Orden procesada: al generar el pedido de una orden de Tango Tiendas.
- Orden facturada: al facturar el pedido generado.
- Orden observada: al intentar generar el pedido de una orden de Tango Tiendas y la misma sea observada. Por ejemplo, cuando se informe una lista de precios inexistente.
- Orden rechazada: al rechazar una orden de pedido.
- Orden cancelada: al cancelar una orden de pedido.
- Factura disponible: al disponer de un comprobante electrónico de facturación en PDF.
Sincronizaciones:
- Actualización de precios: al actualizar el precio de un artículo en 1 o más listas de precios.
- Actualización de saldos: al actualizar el saldo de stock de un artículo en 1 o más depósitos.
Enviar correo electrónico de notificaciones de ventas a los administradores: indique si desea enviar correo electrónico por notificaciones de ventas a los administradores de la tienda. Además, podrá indicar en el recuadro inferior otras direcciones de correo al cual enviar notificaciones.
Finalizada la configuración, presione «Aceptar».
Consulta de datos
La consulta de datos de API, permite acceder a datos de Tango Gestión utilizando la interfaz API para obtener la información.
Para ello, previamente debe asociar una aplicación con API ya que la comunicación es por medio del Access token otorgado.
Se podrá acceder a la siguiente información almacenada en Tango Gestión:
- Clientes (datos del cliente, bonificación, listas de precios por cliente, direcciones de entrega)
- Precios (listas de precios y sus precios)
- Saldos de Stock (en caso que centralice saldos, y así lo haya configurado, se mostrarán los saldos centralizados)
- Artículos (datos del artículo, comentarios)
- Sucursale
- Depósitos
- Unidades de medida
Publicación de comprobantes
Al generar un comprobante electrónico que referencie un pedido cuyo origen sea API, es posible publicar el archivo para permitir su consulta desde el recurso habilitado para tal fin. Para esto, se deberá configurar previamente el talonario de comprobantes electrónicos, teniendo en cuenta las consideraciones detalladas en Definición de talonarios.
Para más información acceda a: https://github.com/TangoSoftware/ApiTiendas.
Preguntas frecuentes
¿Cómo debo armar el JSON para cargar una orden a través de la API?
En la solapa API en Tango Tiendas se muestra un ejemplo del JSON. Además, se puede ver un Modelo, Respuesta, Notificación y Respuesta notificación.
Para más información, acceda a: https://github.com/TangoSoftware/ApiTiendas.
¿El Access token se genera una sola vez?
Se genera un Access token por cuenta. Si se elimina la cuenta, al crear una nueva se generará un nuevo Access token.
¿Qué pasa si elimino el Access token?
Perderá el acceso para enviar órdenes de pedidos desde su API a Tango Gestión y estas tampoco serán recibidas en Revisión de pedidos de Tango Tiendas.
¿A nombre de quién se emite la factura de venta?
Cuando en la orden de pedido viene informado el número del CUIL / CUIT ó DNI y se corresponden con datos de AFIP, será considerada esta información para emitir la factura de ventas en la ausencia de esta información se tomará el Nombre Comercial indicado. Cuando no se informa el número del CUIL / CUIT ó DNI se utilizará el nombre y apellido ingresado en la orden de pedido.
¿Qué ocurre si se pierde la comunicación con el webhook de notificaciones configurado para la Api?
Si no se logra la comunicación con el webhook de notificaciones, se realizarán 3 reintentos en lapsos de 3, 6 y 24 horas respectivamente, si luego de dichos reintentos sigue fallando la comunicación, se le informara vía mail y nexo notificaciones para que revise la configuración de la tienda y realice las acciones correctivas correspondientes.