Odoo

Si operas tu tienda o tus pedidos en Odoo, integrar Envia te permite cotizar y gestionar envíos con tarifas reales de múltiples paqueterías, sin armar cada envío a mano ni saltar entre herramientas. El objetivo es el mismo en todos los casos: cerrar la venta en Odoo y resolver el envío con Envia — comparar opciones, aplicar el costo correcto y avanzar hacia la guía o el fulfillment según el flujo que uses.

Hay tres formas de conectarlas. No son lo mismo: dependen de qué versión de Odoo tienes, cómo está alojada tu instancia e dónde quieres operar (en Envia o dentro de Odoo). Antes de elegir, confirma tu versión y tu tipo de hosting para saber qué opción te aplica y con quién es el soporte.

Confirma tu versión de Odoo

1. Inicia sesión en tu Odoo con un usuario administrador.
2. Vá para Configurações.
3. Abajo a la derecha, o en Acerca de / About, revisa el número de versión.

También puedes verlo en la URL o en el mensaje de bienvenida del panel, según tu instalación.

Cómo saber si es Odoo Online (SaaS), Odoo.sh u On Premise

Tipo	Cómo lo reconoces	En la práctica
Odoo Online (SaaS)	Tu URL suele verse como tudominio.odoo.com. No instalas módulos a mano desde código; usas las Apps que Odoo permite en la nube.	Hosting administrado por Odoo.
Odoo.sh	Entras por el portal de Odoo.sh, tienes branches, builds y despliegues. Puedes instalar módulos desde Apps / repositorio.	Hosting en la plataforma Odoo.sh (más control que Online).
No local	Odoo corre en tu servidor o el de un partner. Tú (o tu integrador) controlan la instalación y el código.	Servidor propio o de un tercero.

ℹ️ Resumen rápido: si tu tienda es solo *.odoo.com sin Odoo.sh > Online (SaaS). Si tienes proyecto en Odoo.sh o servidor propio > .sh u No local.

Módulos para conectar Odoo con Envia.com

	1. OAuth desde Envia.com	2. Plugin Envia para Odoo .sh	3. Plugin / integración nativa Odoo (SaaS)
Versión de Odoo	Concebida para Odoo 18	Odoo 19	Según la versión de Odoo que documente Odoo (consulta su guía oficial)
O que é	Conectas Odoo desde Ecommerce Pro en Envia.com (vía API / OAuth)	Módulo Envia.com: Cotação e Envio em Odoo Apps	Desarrollo directo de Odoo
Dónde la configuras	Em Envia.com	Em Odoo y Envia (Apps + asistente OAuth de Envia)	Em Odoo (Apps / Inventario), con cuenta Envia
Hosting compatible	Según tu instancia Odoo conectable por API	Solo Odoo.sh u No local. Não Odoo Online (SaaS)	Orientada a Odoo Online (SaaS) y flujos nativos de Odoo
Para que serve	Sincronizar pedidos y criar guias da Envia	Cotizar tarifas en vivo en pedidos de Odoo (y tarifas en checkout si lo activas)	Cotizar / enviar desde el flujo de delivery de Odoo, según lo que ofrezca Odoo
Suporte	Envia	Envia	Odoo (es un desarrollo de su plataforma; Envia puede orientar sobre la cuenta Envia, pero el módulo lo soporta Odoo)

Qual é a melhor opção para você?

1. OAuth desde Envia.com. Si quieres operar envíos en Envia (pedidos, cotizar y criar guias) y tu Odoo es compatible (flujo documentado para v18)
2. Plugin Envia (Apps). Si tienes Odoo 19 em Odoo.sh u No local y quieres cotizar dentro del pedido en Odoo.
3. Integración nativa Odoo (SaaS). Si estás en Odoo Online (SaaS) y quieres el conector que Odoo ofrece en su producto. Guía oficial: Envia Shipping en la documentación de Odoo.

¿Soy apto para el plugin nuevo de Envia (opción 2)?

Debes cumplir todo esto:

• Versão Odoo 19.0
• Hosting Odoo.sh u No local (no Odoo Online / *.odoo.com puro)
• Acceso de administrador para instalar Apps y editar odoo.conf (server_wide_modules)
• Cuenta en Envia.com

1. Integrar Odoo desde Oauth de Envia.com

Conecte sua loja Odoo ao Envia.com para automatizar o gerenciamento de remessas e gerar guias de remessa a partir de uma única plataforma.

Essa integração foi projetada para Odoo versão 18. Se você estiver usando uma versão anterior, atualize o Odoo ou verifique a compatibilidade com seu consultor.

1. Faça login em sua conta do Envia.com

2. vá para Ecommerce Pro > Integrações de e-commerce

3. Clique em Integrar meu comércio eletrônico, e selecione Odoo

4. Insira a URL da sua loja Odoo e clique em Continuar.

5. Abra uma nova aba e faça login na sua conta Odoo.

6. No painel do Odoo, clique no menu do usuário no canto superior e selecione Minhas bases de dados

7. Copie o nome da base de dados (o texto exibido abaixo do domínio).

8. Volte para Envia.com e cole esse valor no campo Nome do banco de dados.

9. No campo E-mail do usuário, insira o e-mail que você utiliza para acessar o Odoo.

10. No Odoo, abra o menu do usuário e selecione Minhas preferências.

11. Acesse a seção Segurança e clique em Adicionar chave de API para criar uma nova chave.

12. No campo Para que é esta chave?, digite Envia.com.

13. Na duração da chave, selecione Chave persistente e clique em Gerar chave.

15. Copie a chave de API que acabou de ser gerada.

⚠️ Importante: Esta chave não poderá ser visualizada novamente. Guarde-a em um local seguro antes de continuar.

16. Volte para Envia.com e cole a chave no campo Chaves de API.

17. Clique em Criar para finalizar a configuração.

18. Verifique o e-mail cadastrado na Envia.com e clique em Continuar.

Pronto! Sua loja Odoo agora está integrada com a Envia.com.

Configure sua loja no Envia.com

Essas configurações são feitas diretamente no painel de controle do Envia.com. Elas são essenciais para que a integração funcione corretamente.

Se você já possui o módulo da Envia instalado no Odoo ou prefere realizar a instalação diretamente pelo Odoo, consulte a documentação oficial do Odoo para ver os passos detalhados.

2. Plugin Envia.com (Odoo.sh/On Premise)

Este es el módulo publicado en Odoo Apps. Te permite cotizar tarifas en vivo dentro de Odoo (en el pedido) y, si lo activas, mostrar tarifas en el checkout.

Com o plugin, você calcula o valor do frete dentro do Odoo: você compara empresas de entrega, escolhe o endereço de entrega ou a agência e aplica a tarifa ao pedido. Se você tiver uma loja virtual, seu comprador também poderá ver as tarifas na página de finalização da compra.

Requisitos

• Versión del plugin: 19.0.1.0.0
• Apps Store: Envia.com: Cotação e Envio
• Solo Odoo.sh u On Premise — no aplica en Odoo Online (SaaS)
• Odoo 19.0 em Odoo.sh u No local
• Acceso de administrador
• Poder editar odoo.conf (server_wide_modules)

ℹ️ Esta versão do plugin calcula tarifas. Ela não gera notas fiscais nem rastreamento no Odoo. Os guias são criados no Envia.com.

1. Instalar el módulo

• En Odoo, ve a Apps
• Busque Envia.com: Cotação e Envio (o envia).
• Instala el módulo.

Si no aparece, confirma que el módulo esté en el addons path de tu instancia y actualiza la lista de Apps.

2. Activa el módulo HTTP (obligatorio)

En el archivo de configuración de Odoo (odoo.conf), el módulo debe quedar como servidor amplio, por ejemplo:

server_wide_modules = web,base,envia_http

ℹ️ Sin este paso, la conexión OAuth / callback puede fallar. Reinicia Odoo si tu entorno lo requiere tras editar la configuración.

3. Conecta tu cuenta Envia

• Vá para Ventas > Configuración > Envia.com Shipping.
• En el asistente, inicia la conexión.
• Inicia sesión en Envia.com y autoriza el acceso.
• Al volver a Odoo, la integración queda activa (se crea la API key de integración de forma automática; no necesitas pegarla a mano).

4. Configura tu tienda en Envia.com

• En Envia.com, ve a Ecommerce Pro > Configure sua Loja
• Define a endereço de origem predeterminada (desde dónde salen tus envíos).
• Configura tus pacotes (medidas / tipos de empaque que usarás al cotizar).
• Activa la Cotação automática no checkout da loja y elige las paqueterías que deseas mostrar en las cotizaciones
• Salve as alterações.

5. Cotiza en Odoo un pedido

• Abre un pedido de venta en Odoo.
• Clique em Adicionar frete.
• Escolha Envia.com.
• Elige si el envío es a domicilio o a filial del transportista (cuando la paquetería lo permita).
• Verifique a origem, o destino e o peso e clique em Verificar tarifa.
• Compare tarifas, escolha o serviço e clique em Adicionar.

El peso se toma del producto en Odoo. Si un producto no tiene peso, el módulo usa 1 kg por padrão.

Perguntas frequentes

¿Odoo.sh y Odoo Online (SaaS) son lo mismo?

• Online (SaaS) es la nube estándar de Odoo (*.odoo.com), con menos control para instalar módulos externos.
• Odoo.sh es otra forma de alojar Odoo, con despliegues y más flexibilidad para instalar módulos como el de Envia (opción 2).