Pular para o conteúdo
Documentação do usuário

Integração Envia.com

Envia.com é um serviço de envio que conecta empresas com múltiplas operadoras no Odoo. Os principais recursos incluem:

  • Multi-carrier & international shipping: Compare rates across carriers and select the best option for domestic or global shipments.

  • Automated label generation: Generate shipping labels at order confirmation.

  • Real-time rate calculation: Fetch rates based on package details and destination.

Configuração no Envia

Para integrar Envia.com ao Odoo, primeiro crie uma conta e ative as operadoras de envio necessárias. Em seguida, obtenha as credenciais de API, que são usadas para conectar Envia.com ao banco de dados Odoo.

Crie uma conta e ative as operadoras

Comece acessando Envia.com.

Depois de fazer login, na barra lateral esquerda, clique em Configurações › Opções de impressão e operadoras. Em seguida, selecione o país para definir a moeda e exibir as operadoras de envio disponíveis.

Depois de decidir sobre a operadora desejada, clique em Ativar, depois clique em Serviços para selecionar as opções de envio disponíveis da operadora.

Select carrier services.

Gerar credenciais Envia.com

Acesse Envia.com, navegue até Desenvolvedores › Chaves de API, no menu esquerdo, depois clique em adicionar para gerar uma nova chave.

Esta chave é necessária para autenticar a conexão do Odoo com Envia.com. Recupere-a a qualquer momento voltando à seção Chaves de API.

API Keys in Envia.com.

Configuração no Odoo

Instale <general/install> o módulo Envio Envia (delivery_envia) e prossiga para as seções a seguir para configurar a integração no Odoo.

Configuração do conector de envio Envia.com

Após ativar o conector Envia.com, crie um método de entrega acessando Inventário › Configuração › Métodos de Entrega e clique em Novo.

Preencha os seguintes campos do formulário:

  • Shipping Method: Name of the shipping method, e.g. Envia.com.

  • Provider: Select Envia from the drop-down menu.

  • Delivery Product: The product listed on the sales order as the delivery charge. A specific delivery product for Envia.com must be created.

  • In the Envia Configuration tab, enter the Envia Production Access Token.

  • In the Envia Configuration tab, enter the Envia Sandbox Access Token.

  • Insurance percentage: If insurance is needed, place a percentage of the value to insure. If not, leave it as 0. Keep in mind that the insurance price is calculated only after the label has been generated, including for LTL shipments.

Considerações adicionais para o Pacote Padrão Envia:

  • The package is specified in mm and kg. The weight refers to the container itself, not its contents. Leave the weight as 0 if no weight is reported, and set the max weight to 0 if there is no specified limit.

  • Envia Package Type: Set to Box by default. Ensure the correct type is selected, as it affects the available carriers and options displayed, which vary depending on this selection.

Após configurar corretamente os campos anteriores, navegue até a aba Configuração Envia e no campo Nome do Serviço Envia.com, clique no ícone fa-refresh (atualizar) para sincronizar as transportadoras. Na janela pop-up que aparece, selecione uma transportadora e um nível de serviço da lista.

Envia.com carrier and services popup.

Informações de envio

Para usar Envia.com para gerar etiquetas de envio, as seguintes informações devem ser preenchidas com precisão e completude no Odoo:

  1. Customer information: When creating a quotation, ensure the selected Customer has a valid phone number, email address, and shipping address.

    To verify, select the Customer field to open their contact page. Here, add their shipping address in the Contact field, along with their Mobile number and Email address.

  2. Product weight: Ensure all products in a delivery order have a specified Weight in the Inventory tab of their product form. Refer to the Product weight section <inventory/shipping_receiving/configure-weight> of this article for detailed instructions.

  3. Warehouse address: By default all packages are sent from the specified address in the warehouse, make sure to set the address for correct label generation.

Guia de preenchimento de endereço

Cada país possui regras sobre como um endereço é preenchido. Este é um guia abrangente das exceções de campos esperados de cada país:

Country

Street

Street 2

City

State_id

Argentina

Street and number

Locality

City

Province

Brazil

Exception

Neighborhood

City

State

Chile

Street and number

City

Commune

Region

Colombia

Street and number

Not needed

Municipality

Department

Guatemala

Street and number

Neighborhood

City

State

Mexico

Street and number

Neighborhood

City

State

Uruguay

Street and number

Complementary info

Locality

State

Países não listados aqui devem ser inseridos normalmente.

Para a Colômbia, o código postal é extraído da cidade selecionada em city_id se a localização estiver instalada, caso contrário o Odoo utilizará o campo de código postal.

Gerar etiquetas com Envia

Ao criar uma cotação no Odoo, adicione o envio e o produto de envio Envia.com. Em seguida, Valide a entrega. Documentos de etiqueta de envio são gerados automaticamente no chatter, que incluem o seguinte:

  1. Shipping label(s) depending on the number of packages.

  2. Return label(s) if the Envia.com connector is configured for returns.

Além disso, o número de rastreamento fica disponível.

Envio internacional

Para envios internacionais é necessário preencher tanto o código HS quanto o país de Origem das Mercadorias, ambos podem ser encontrados na aba Inventário do produto.

Envios LTL

Etiquetas de envio LTL podem ser geradas através do conector Envia. O seguro para envios LTL é baseado no percentual de seguro especificado no formulário do método de entrega.

Rastreamento e cancelamento

Envios registrados com Envia podem ser rastreados utilizando o botão inteligente Rastreamento na ordem de entrega ou utilizando o link de rastreamento do portal do cliente.

Customer portal tracking.

FAQ

Medição de peso volumétrico

Muitas transportadoras possuem várias medidas para peso. Existe o peso real dos produtos na encomenda e o peso volumétrico. Peso volumétrico é o volume que uma encomenda ocupa durante o transporte, ou seja, o tamanho físico de uma encomenda.

Quais opções de impressão estão disponíveis?

No Envia.com em Configurações › Opções de impressão e Opções de impressão de Transportadoras para cada uma das transportadoras exibidas, certifique-se de usar o formato apropriado para a transportadora escolhida.

O serviço necessário não está disponível

Para transportadoras disponíveis, certifique-se de que estejam habilitadas através da Envia.

Quem pagará os direitos aduaneiros?

É importante certificar-se de que se houver exportações para outros países, use as configurações de transportadora da Envia para definir se é pago pelo remetente ou pelo destinatário.

O que é "erro Envia"?

É uma mensagem que aparece quando há um erro no Envia. Esta mensagem menciona o que deu errado em sua plataforma para que possa ser resolvido.