DOCS > RECURSOS PARA PROFESIONALES
Introducción
Gosbi pone a disposición las herramientas descritas en esta documentación con el objetivo de facilitar
la relaciones entre el profesional y su distribuidor por medio de API - Rest.
Antes de empezar es importante leer el funcionamiento general y tener acceso a la B2B de Gosbi.
Obtener del token para autenticar las peticiones:
Entramos en la web https://b2b.gosbi.com y vamos al apartado GosbiConnect
En este apartado encontraremos nuestro token de autenticación para las peticiones a la API y podremos regenerarlo tantas veces cómo queramos.
P.1: Obtener productos disponibles
Obtener la información actualizada de productos Gosbi y la disponibilidad de stock
de nuestro distribuidor.
Ver especificación técnica...
Información del recurso:
- Url: /3rdp/b2b/products
- Method: GET
- Document: None
Estructura del documento a recibir:
| Ruta |
Campo |
Tipo |
Descripción |
| / |
id |
int |
Id Gosbi única de producto |
| / |
name |
str |
Nombre de producto |
| / |
image_front |
str |
Url de imágen principal |
| / |
in_stock |
bool |
Disponibiliad de stock del distribuidor |
| / |
formats |
array |
Lista de formatos de compra del producto |
| formats/ |
ean |
str |
Código EAN del formato |
| formats/ |
quantity |
int |
Unidades de venta de dicho formato |
| formats/ |
buyable |
bool |
Disponibilidad de compra (al distribuidor) del formato |
Ejemplo petición:
Respuesta:
P.2: Realizar pedido al distribuidor
Realizar un pedido de compra al distribuidor.
El mismo recurso acepta dos objetos diferentes dependiendo si se prefiere hacer el pedido por EAN o por ID de artículo.
La respuesta recibida va a ser la misma para las dos opciones.
P.2.1. Opción petición por ID
Ver especificación técnica...
Información del recurso:
- Url: /3rdp/b2b/order
- Method: POST
- Document: JSON
Estructura del documento a enviar:
| Ruta |
Campo |
Tipo |
Descripción |
| / |
lines |
array |
Array de productos a pedir |
| lines/ |
id |
int |
Id Gosbi única de producto |
| lines/ |
quantity |
int |
Cantidad del producto a pedir |
| / |
text |
str |
Texto para el distribuidor |
Ejemplo petición:
Ejemplo respuesta:
P.2.2. Opción petición por EAN
Ver especificación técnica...
Información del recurso:
- Url: /3rdp/b2b/order
- Method: POST
- Document: JSON
Estructura del documento a enviar:
| Ruta |
Campo |
Tipo |
Descripción |
| / |
lines |
array |
Array de productos a pedir |
| lines/ | ean |
str |
EAN de formato pedido |
| lines/ |
quantity |
int |
Cantidad del formato a pedir |
| / |
text |
str |
Texto para el distribuidor |
Ejemplo petición:
Ejemplo respuesta:
P.3: Verificación stock de un pedido al distribuidor
Obtener la información actualizada del stock de los productos del pedido que se quiere tramitar.
Ver especificación técnica...
Información del recurso:
- Url: /3rdp/b2b/order/stock/checked
- Method: POST
- Document: JSON
Estructura del documento a recibir:
| Ruta |
Campo |
Tipo |
Descripción |
| / |
lines |
array |
Array de productos a pedir |
| lines/ | ean |
str |
EAN de formato pedido |
| lines/ |
quantity |
int |
Cantidad del formato a pedir |
Ejemplo petición:
Respuesta:
