Conector básico con API 20 Bananas
Esto tiene que hacer el informático para que puedas recibir pedidos, que tus clientes vean los productos y ponerte a andar. Si te va bien siempre puedes avanzar e hilar más fino con muchas más funciones.
Funciones (esto es para el NO informático):
- Invitar a clientes con su código de cliente desde la app del vendedor
- Cargar los productos que ya pide ese cliente, lo que llamamos favoritos que facilita muchísimo el primer minuto del cliente y la recurrencia de uso
- Tener todos los productos que vendes visibles para todos tus clientes
- Insertar pedidos en tu sistema de facturación ERP
Endpoints y métodos que debes usar y el json que manejaras (esto es para el developer que tiene que hacerlo):
//CLIENTES (Envíalos todos por que el vendedor en su app es el que decide a cuales invita, a cuales no, a cuales borra... )
https://api.20bananas.com/v2.7.php/clientes/
POST
{
"activo": "s",
"codcliente": "430003645",
"nombrecliente": "Restaurante Sobrino de Botin",
}
//PRODUCTOS (Todo lo que vende la distribuidora, aquí si debes gestionar con los diferentes métodos para mantener sólo los productos a la venta cada día)
https://api.20bananas.com/v2.7.php/productos
POST, PUT, DELETE
{
"activo": "1",
"referencia": "94795753",
"nombre": "Bananas",
"familia": "Frutas y Verduras",
"subfamilia": "Frutas",
"precio": "0.85",
"unidad": "Kg",
"descripcion": "Producto de alta calidad comprado diariamente.</b>.",
"foto": "https://img.freepik.com/fotos-premium/platano-sobre-fondo-blanco_88281-24.jpg",
}
//PRODUCTOS FAVORITOS (Los favoritos del cliente que ha comprado en el último año para ayudarle a usar la app desde el primer día)
https://api.20bananas.com/v2.7.php/habituales
POST
{
"referencia": "131325",
"codcliente": "430003645"
}
//PEDIDOS (Importante que tu ERP no pare de importar los pedidos si no trae código de cliente)
https://api.20bananas.com/v2.7.php/pedidos
{
"idpedido": "2233898",
"codcliente": "430003645",
"nombrecliente": "Restaurante Sobrino de BotIn",
"fecha": "2023-06-06",
"hora": "10:57",
"totalimporte": "16.08",
"comentarios": "lo necesito para mañana",
"fechaEntrega": "2023-06-9",
"productos": [
{
"referencia": "0001",
"nombre": "Bananas",
"cantidad": 1,
"unidad": "Bolsa",
"precio": 5.28,
"observaciones": "maduras por favor",
},
]
}