Tutorial de procesamiento de pedidos
«Este Tutorial API REST muestra a un integrador de sistemas cómo se utilizan en el ciclo de vida de un pedido, incluida la configuración de una tienda y la creación de un cliente. Además, explica cómo crear cotizaciones, pedidos, facturas y envíos, así como preparar el pago y realizar otras tareas relacionadas con la gestión de pedidos.»
El tutorial de 10 pasos generalmente dura 30 minutos .
Antes de que empieces
Complete los siguientes requisitos previos:
Instale una instancia de Adobe el SellerCenter con datos de muestra.
Información Básica para este Tutorial API REST.
Punto final: Esta sección enumera el verbo HTTP y la ruta completa al punto final. La estructura básica de una llamada API REST en Seller center es:
<HTTP verb> http://<host>/api/<endpoint>
dónde:
| ELEMENTO | DESCRIPCIÓN |
| HTTP verb | Uno de GET, POST, PUT, o DELETE |
| host | El nombre de host o dirección IP (y opcionalmente, puerto) de la instalación de SellerCenter. |
| scope | Especifica a qué tienda afecta la llamada. En este tutorial, este valor es default. |
| endpoint | El URI (Identificador uniforme de recursos) completo para el punto final. Estos valores siempre comienzan con /V1. Por ejemplo, /V1/orders/4 |
| {sellerId} | Este parámetro podras obtenerlo en tu dashboard general de SC, también podrás reemplazarlo por el vtexId de tu seller que igualmente podrás obtenerlo en tu dashboard general. |
| {warehouseId} | Este parámetro podrás obtenerlo en tu dashboard general, podrás reemplazarlo por el texid del warehouse, igualmente podrás obtenerlo en tu dashboard general |
Encabezados HTTP:
Esta sección indica qué pares clave/valor debe especificar en los encabezados HTTP. Todas las llamadas requieren uno o más encabezados HTTP.
Carga útil:
Esta sección enumera la información que se envía a Comercio. Todos los ejemplos de carga útil son válidos y se pueden copiar y pegar en sus llamadas, pero es posible que deba cambiar los idvalores que devuelve el SellerCenter.
Respuesta:
Esta sección enumera la información que el SellerCenter envía al cliente de la API REST. A menudo se hace referencia a estos valores en otros pasos del tutorial. Los valores que devuelve el SellerCenter pueden ser diferentes de los valores enumerados en los ejemplos proporcionados en este tutorial.
Obtenga el token de autorización
Es necesario crear un token de integración con cualquier llamada API REST. El token permite al sellerCenter verificar que la persona que llama está autorizada para acceder a un recurso del sistema.
De forma predeterminada, un token de administrador es válido durante durante el día.
Punto final:
POST <host>/api/login
Encabezados:
Content-Type: application/json
Carga útil:
curl –location ‘https://sellercenter.com.mx/api/login’ \
–form ‘email=»example-user@sellercenter.com.mx»‘ \
–form ‘password=»password-example»‘
Respuesta:
El SellerCenter devuelve el token de acceso del cliente. Este token debe especificarse en el encabezado de autorización de cada llamada que el cliente realice en su propio nombre.
«access_token»: «7|HYterrt789456YUeUYI»,
me sin aporte al seller
Utiliza este endpoint para obtener los datos actuales de la sesión iniciada.
no tiene sentido por que ninguno de los datos que muestra puede ser usado en algún endpoint
Punto final:
GET <host>/api/user
Encabezados:
Content-Type: application/json
Carga útil:
curl –location ‘https://sellercenter.com.mx/api/user’
Postman
Respuesta:
El SellerCenter responde con la información del usuario
logout
api/logout
Punto final:
POST <host>/api/logout
Encabezados:
Content-Type: application/json
Carga útil:
curl –location –request POST ‘https://<host>/api/logout’
Respuesta:
El SellerCenter
Product
storebuybox
Integración con shipment para almacenar el buybox de cada producto.
SellerId: Puede ser el de sellerCenter o el vtex id de vtex
WarehouseId: Puede ser el de sellerCenter o el vtex id de vtex
Punto final:
POST <host>/api/user
Encabezados:
Content-Type: application/json
Carga útil:
curl –location ‘https://sellecenter.com.mx/api/storebuybox’ \
–header ‘Content-Type: application/x-www-form-urlencoded’ \
–header ‘Authorization: <token>’ \
–form ‘vtex_seller_id=»<selerId>»‘ \
–form ‘bind_sku_id=»18″‘ \
–form ‘bind_product_id=»13″‘ \
–form ‘price=»1234″‘
Respuesta:
El SellerCenter
{
«error»: «Invalid ability provided.»
}
getProduct
Utiliza este endpoint para obtener los datos actuales del producto por SKU.
Punto final:
POST <host>/api/seller/2/warehouse/1/product?sku=12
Encabezados:
Content-Type: application/json
Carga útil:
curl
Respuesta:
El SellerCenter muestra la info actual del producto en vtex.
Punto final:
POST <host>/api/login
Encabezados:
Content-Type: application/json
Carga útil:
curl
Respuesta:
El SellerCenter
Punto final:
POST <host>/rest/<store_code>/V1/integration/customer/token
Encabezados:
Content-Type: application/json
Carga útil:
Respuesta:
Commerce devuelve el token de acceso del cliente. Este token debe especificarse en el encabezado de autorización de cada llamada que el cliente realice en su propio nombre.
q0u66k8h42yaevtchv09uyy3y9gaj2ap
https://documenter.getpostman.com/view/27522341/2s93sZ5tCh#5b74070d-a367-4f90-aab9-f57311a63b0f
- api/login
{
«access_token»: «00|AAABBBBCCCCCVVVVRRRFGG»,
«token_type»: «bearer»,
}
- updateOnHand
api/seller/2/warehouse/24/product/update/onhand?sku=null&on_hand=null
PARAMS
sku required, numeric
onhand required, numeric
PARAMS INDIRECTOS
seller/2
warehouse/24
- api/login
{
«access_token»: «00|AAABBBBCCCCCVVVVRRRFGG»,
«token_type»: «bearer»,
}
El escenario es.
Un «SellerCenter” Tiene sellers que se conectaran por api al sellerCenter
- /api/login
- Params: emaiil ,password
- Response: access_token
Adicionalmente a este Tutorial API REST, también puede revisar la integración Vtex-to-Vtex.
