Primeros pasos con la API

Todas las acciones se envían como XML a https://apiv2.wibi.com.ar/onzecrm/ con el token y la api-key. Cada paso enlaza a la referencia con los campos y ejemplos completos.

1. Pedí tus credenciales. Necesitás una api-key (identifica a tu sistema) y el usuario y contraseña del comercio que va a operar. Los entrega WIBI.
2. Obtené un token. Enviá usuario y contraseña a POST /onzecrm/token con el header api-key. La respuesta trae el token y su vencimiento: reutilizalo hasta que venza, no pidas uno por cada operación. Ver en la referencia →
3. Entendé la respuesta. Todas las acciones responden con RespCode (0 = éxito, 1 = error) y RespMsg con el detalle. Registrá siempre el mensaje de error. Ver en la referencia →
4. Registrá al cliente. Acción 100 (o 103 si el número de tarjeta es el DNI). Si el cliente ya existe, WIBI lo actualiza: no hace falta consultar antes. Ver en la referencia →
5. Informá una venta. Acción 200 con el número de comprobante y, si los tenés, los productos vendidos (habilitan promociones y reportes por producto). WIBI calcula y acredita los puntos según las reglas de la campaña. Ver en la referencia →
6. Consultá los puntos. Acción 300 devuelve los datos y el saldo del cliente; 301, sus movimientos. Ver en la referencia →
7. Devoluciones y anulaciones. Usá 201 (devolución parcial) y 202 (cancelación) para que los puntos queden bien. Ver en la referencia →

¿Tu sistema no puede armar XML?

Podés enviar ventas, devoluciones y anulaciones en un archivo CSV. Ver integración por archivo →