Integradora o integración propia
- Crea la APP en el portal: los tokens de Sandbox salen al momento.
- Prueba los flujos y solicita la validación técnica.
- Validada, recibes un nuevo client_id de Producción.
Una única integración para vender en los sitios del Grupo Netshoes: catálogo, precio, stock, pedidos y entregas por la API.
Los tres pasos de toda integración con la API Marketplace.
Regístrate en el Portal de Desarrolladores para crear tu APP y Token de Sandbox, donde podrás hacer pruebas de integración.
Crear cuentaHaz las pruebas en el entorno de sandbox, solicita tu validación técnica y queda listo para integrarte a la API Marketplace del Grupo Netshoes en Producción.
Conocer el SandboxCon el acceso liberado en Producción, podrás enviar tu carga de productos y seguirla hasta que esté disponible en el marketplace.
Reglas de producciónCon la APP creada, los tokens de Sandbox ya están en Mis Apps. La primera llamada lista los departamentos del sitio — con ellos armas el producto.
curl https://api-sandbox.netshoes.com.br/api/v1/bus/NS/departments \
-H "client_id: $CLIENT_ID" \
-H "access_token: $ACCESS_TOKEN" \
-H "content-type: application/json"Esto es lo que tu integración hace todos los días: mover cada entrega del pedido hasta el cliente. Elige un estado para ver su llamada y su regla.
La llamada
PUT /api/v1/orders/{orderNumber}/shippings/{shippingCode}/status/invoiced
client_id: {client_id}
access_token: {access_token}La regla
La facturación lleva la factura en el campo danfeXml, con las comillas escapadas, y se procesa de forma asíncrona. Es aquí que la reserva de stock se descuenta de hecho.
Ver la referencia de Pedidos y entregasY dos reglas que valen siempre: una solicitud de más de 1 MB responde 413, y si pasas el límite de llamadas por minuto recibes 429.
El mayor minorista online de deporte también es la marca de lifestyle deportivo que hace más de 20 años lleva el deporte a los hogares brasileños — parte del Grupo Magalu desde 2019.
Cursos cortos, guías del día a día del seller y los términos que aparecen en la integración.
Las preguntas frecuentes responden sobre tokens, registro de productos, stock y pedidos. ¿No la encontraste? Abre un ticket con el equipo del Marketplace.
No. Una única integración basta para vender sus productos en nuestros sitios. El stock es compartido entre ellos y lo gestionamos nosotros. También notará que algunos métodos de nuestra API tienen el parámetro "BU" (Business Unity), que identifica a qué sitio se envía la información. Si el método lo permite y desea que la información aparezca solo en Zattini, envíe la business unity ZT. Para Netshoes, envíe la business unity NS. Algunos métodos piden opcionalmente el país: envíe BR. Las dos URL de nuestras API, para Sandbox y para producción, funcionan para los dos sitios.
No hay un plazo definido, porque el proceso incluye verificaciones manuales en el camino. Normalmente el plazo es de 2 días, pero en algunos casos puede llevar algunas semanas.
Created (Creado) > Approved (Aprobado) > Invoiced (Facturado) > Shipped (Enviado) > Delivered (Entregado).
Los vendedores deben contactar al analista comercial responsable de la cuenta y solicitar la clave de acceso. Los integradores, o quien tenga integración propia, deben pasar por la validación técnica.
No. Una vez que el producto está en catalogación y disponible para la venta, no puede modificarse. Solo es posible cambiarlo cuando está en el estado 'recibido' o 'criticado', como se describe en: [Reglas y uso en producción](/docs/general/regras-e-uso-em-producao#obtenção-do-token-de-produção). Si es necesario en Producción, solicite la eliminación interna del producto y regístrelo de nuevo. En Sandbox no es posible eliminar, porque la API no permite ninguna acción de eliminación.
¿No encontraste tu duda?
Abrir un ticket