Integración Melhor Envio

Guía completa para configurar la integración con Melhor Envio a través de Fanmarket.

📥 Collection Postman

Descargar Collection - Melhor Envio

Prerrequisitos

Antes de comenzar, necesitará:

• Cuenta en Melhor Envio (homologación o producción)
• Credenciales de acceso proporcionadas por Fanbase
• URL de callback configurada junto con Fanbase

Entornos

Homologación:

• URL Melhor Envio: https://sandbox.melhorenvio.com.br
• URL Fanmarket: {fanmarket-homologacao} = https://fanmarketapi.fantest.com.br

Producción:

• URL Melhor Envio: https://melhorenvio.com.br
• URL Fanmarket: {fanmarket-producao} = https://fanmarketapi.fanbase.com.br

Paso 1: Crear Cuenta en Melhor Envio

1. Acceda al sitio web de Melhor Envio:

   • Homologación: https://sandbox.melhorenvio.com.br/login
   • Producción: https://melhorenvio.com.br/login

2. Cree una cuenta o inicie sesión

Paso 2: Crear Aplicación

1. En el menú lateral, acceda a Integraciones → Área Dev
2. Haga clic en Registrar Aplicación
3. Complete el formulario con los siguientes datos:

Campo	Valor
Nombre de la Plataforma	Fanmarket
E-mail de contacto	Su e-mail de contacto
URL de su entorno para pruebas	{fanmarket-homologacao}
Sitio web de la plataforma	{fanmarket-producao}
E-mail de su soporte técnico	E-mail del soporte
URL de redirección después de autorización	Proporcionado por Fanbase
Descripción de la aplicación	Descripción de su aplicación

4. Después de crear, anote el Client ID y Secret generados

Paso 3: Obtener Credenciales

Después de crear la aplicación, recibirá:

• Client ID: Identificador público de la aplicación
• Secret: Clave secreta (debe mantenerse confidencial)

Envíe estas credenciales a Fanbase para configuración.

Paso 4: Liberar Permisos

Para liberar los permisos de cotización de flete, necesita autorizar la aplicación a través de un enlace de autorización.

Generar Enlace de Autorización

El enlace debe seguir el formato a continuación:

https://{{UrlMelhorEnvio}}/oauth/authorize?client_id={{ClientId}}&redirect_uri={{UrlCallback}}&response_type=code&state={{State}}&scope=shipping-calculate ecommerce-shipping

Parámetros

Parámetro	Descripción	Ejemplo
UrlMelhorEnvio	URL del entorno Melhor Envio	sandbox.melhorenvio.com.br (homologación) o melhorenvio.com.br (producción)
ClientId	Client ID generado en el paso 2	1010
UrlCallback	URL de callback proporcionada por Fanbase	{fanmarket-homologacao}/api/delivery/shipping/callback/teste
State	Valor de estado (puede ser cualquier cadena)	teste (homologación) o prod (producción)
scope	Permisos solicitados	shipping-calculate ecommerce-shipping

Ejemplo de Enlace Completo

Homologación:

https://sandbox.melhorenvio.com.br/oauth/authorize?client_id=1010&redirect_uri={fanmarket-homologacao}/api/delivery/shipping/callback/teste&response_type=code&state=teste&scope=shipping-calculate ecommerce-shipping

Producción:

https://melhorenvio.com.br/oauth/authorize?client_id=1010&redirect_uri={fanmarket-producao}/api/delivery/shipping/callback/prod&response_type=code&state=prod&scope=shipping-calculate ecommerce-shipping

Paso 5: Autorizar Aplicación

1. Abra el enlace generado en el paso 4 en el navegador
2. Inicie sesión en la plataforma Melhor Envio (si es necesario)
3. Autorice los permisos solicitados
4. Será redirigido automáticamente a la URL de callback
5. Debe aparecer el mensaje: "Token guardado con éxito"

Verificación

Después de completar todos los pasos, el token será guardado automáticamente por Fanbase. Si aparece cualquier mensaje diferente de "Token guardado con éxito", contacte al soporte de Fanbase.

Próximos Pasos

Después de la configuración, podrá utilizar los endpoints de Fanmarket para calcular y gestionar fletes a través de Melhor Envio.

Soporte

En caso de dudas o problemas durante la configuración, contacte al soporte técnico de Fanbase.