Documentação

Como configurar suas transportadoras

A Etrovvo conecta diretamente com a sua conta em cada transportadora para gerar cotações em tempo real, criar etiquetas e rastrear envios. Abaixo você encontra o passo a passo para obter as credenciais de API de cada operador, organizados por país.

🇧🇷 Brasil

Correios▼

Campos necessários: Cartão de Postagem, Código Administrativo, Senha

  1. Acesse meu.correios.com.br e faça login com a conta PJ da sua empresa.
  2. Vá em "Meus Contratos" e localize o contrato ativo de e-commerce.
  3. Copie o Cartão de Postagem (geralmente começa com "0076…").
  4. Copie o Código Administrativo exibido nos detalhes do contrato.
  5. A Senha é a mesma usada para acessar o portal Meu Correios.

Se você ainda não tem contrato, solicite pelo Gerente Comercial dos Correios da sua região ou pelo portal "Correios Log+".

Portal do desenvolvedor

Total Express▼

Campos necessários: Client ID, Client Secret

  1. Entre em contato com a Total Express pelo site totalexpress.com.br ou pelo seu executivo de contas.
  2. Solicite acesso à API de integração e-commerce.
  3. Após aprovação, você receberá o Client ID e Client Secret por e-mail.

Portal do desenvolvedor

J&T Express▼

Campos necessários: API Key, Company ID

  1. Acesse o portal de parceiros da J&T Express Brasil.
  2. Faça login ou crie uma conta comercial.
  3. No menu "Integrações" ou "API", gere uma nova API Key.
  4. Copie a API Key e o Company ID atribuído à sua conta.

Se o menu de API não estiver disponível, solicite a ativação ao seu gerente de contas J&T.

Portal do desenvolvedor

Loggi▼

Campos necessários: API Key (Bearer Token)

  1. Acesse loggi.com e faça login na sua conta empresarial.
  2. Navegue até "Configurações" → "API / Integrações".
  3. Clique em "Gerar novo token" e copie o Bearer Token exibido.

O token não é exibido novamente após sair da página — salve-o em local seguro.

Portal do desenvolvedor

Jadlog▼

Campos necessários: CNPJ, Senha, Conta

  1. Acesse jadlog.com.br e faça login no Jadlog Embarcador.
  2. Em "Configurações" → "Dados da empresa", copie o CNPJ.
  3. A Senha é a mesma usada para acessar o Jadlog Embarcador.
  4. O número da Conta aparece no canto superior direito do painel.

Portal do desenvolvedor

FedEx Brasil▼

Campos necessários: API Key, Secret Key, Account Number

  1. Acesse developer.fedex.com e crie uma conta (ou faça login).
  2. Crie um novo projeto (Organization → Create Project).
  3. Na seção "API Authorization", copie a API Key e Secret Key.
  4. O Account Number é o número da sua conta FedEx comercial (9 dígitos).

Use a opção "Test Key" para testar em sandbox antes de ir para produção. O mesmo processo se aplica para FedEx em qualquer país.

Portal do desenvolvedor

🇦🇷 Argentina

Andreani▼

Campos necessários: Usuário, Password, Número de Cliente

  1. Contrate o serviço de logística em andreani.com.
  2. Solicite ao seu executivo de contas o acesso à API.
  3. Você receberá: Usuário, Password e Número de Cliente.

Portal do desenvolvedor

Correo Argentino▼

Campos necessários: Client ID, Client Secret

  1. Acesse correoargentino.com.ar e entre na seção "MiCorreo Empresas".
  2. Registre sua empresa e solicite acesso ao serviço de e-commerce.
  3. No painel de desenvolvimento, crie uma aplicação para obter o Client ID e Client Secret.

O processo de aprovação pode levar até 5 dias úteis.

Portal do desenvolvedor

OCA e-Pak▼

Campos necessários: CUIT, Operativa, Usuário, Password

  1. Contrate o serviço e-Pak em oca.com.ar.
  2. Após a ativação, você receberá seu CUIT de operação e código de Operativa.
  3. Solicite o Usuário e Password de acesso ao webservice ao seu contato comercial OCA.

A Operativa define o tipo de serviço (ex: 77790 = Estándar, 77791 = Prioritario).

Portal do desenvolvedor

DHL Express Argentina▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com e crie uma conta.
  2. Registre um novo app no painel de desenvolvedores e copie a API Key.
  3. O Account Number é o número da sua conta DHL Express (9-10 dígitos).

As mesmas credenciais DHL funcionam para todos os países (AR, MX, ES, PT, IT, UK).

Portal do desenvolvedor

UPS Argentina▼

Campos necessários: API Key, Username, Password, Account Number

  1. Acesse developer.ups.com e crie uma conta de desenvolvedor.
  2. Registre um novo aplicativo e selecione as APIs "Rating" e "Shipping".
  3. Copie a API Key (Client ID) gerada.
  4. Informe seu Username e Password do ups.com.
  5. O Account Number é o número da sua conta UPS (6 caracteres alfanuméricos).

As mesmas credenciais UPS funcionam para todos os países (AR, MX, US, CA, ES, IT, UK).

Portal do desenvolvedor

FedEx Argentina▼

Campos necessários: API Key, Secret Key, Account Number

  1. Mesmo processo do FedEx Brasil — acesse developer.fedex.com.
  2. Crie um projeto, copie API Key, Secret Key e Account Number.

Portal do desenvolvedor

🇲🇽 México

Estafeta▼

Campos necessários: Client ID, Client Secret, Subscription Key

  1. Acesse estafeta.com/herramientas/webservice e solicite acesso à API.
  2. Após aprovação, acesse o Azure API Management da Estafeta.
  3. Crie um aplicativo para obter o Client ID e Client Secret.
  4. Copie a Subscription Key (Ocp-Apim-Subscription-Key) do seu perfil no portal.

A Subscription Key é obrigatória — sem ela as chamadas à API serão rejeitadas.

Portal do desenvolvedor

Correos de México▼

Campos necessários: API Key (Bearer Token)

  1. Contrate o serviço de envíos empresariais em correosdemexico.gob.mx.
  2. Solicite acesso à API ao seu contato comercial.
  3. Você receberá um Bearer Token para autenticação.

Portal do desenvolvedor

FedEx México▼

Campos necessários: API Key, Secret Key, Account Number

  1. Mesmo processo — acesse developer.fedex.com, crie projeto e copie as credenciais.

Portal do desenvolvedor

DHL Express México▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com, registre um app e copie a API Key + Account Number.

Portal do desenvolvedor

UPS México▼

Campos necessários: API Key, Username, Password, Account Number

  1. Acesse developer.ups.com, registre app e copie as 4 credenciais.

Portal do desenvolvedor

🇨🇱 Chile

Chilexpress▼

Campos necessários: Subscription Key (Ocp-Apim), Customer Card Number

  1. Acesse developers.chilexpress.cl e crie uma conta de desenvolvedor.
  2. Subscreva os produtos "Rates", "Geo" e "Transport Orders".
  3. Copie a Ocp-Apim-Subscription-Key (Primary Key) de cada produto.
  4. Se já tem contrato Chilexpress, informe o Customer Card Number do contrato.

Para criar etiquetas reais é necessário ter contrato comercial ativo com a Chilexpress.

Portal do desenvolvedor

Correos de Chile▼

Campos necessários: Client ID, Client Secret, Número de Contrato, RUT

  1. Acesse correos.cl/web/clientes/empresas e contrate o serviço corporativo.
  2. Solicite ao seu executivo comercial o acesso à API REST (OAuth2).
  3. Você receberá Client ID, Client Secret e o número de Contrato.

A ativação da API pode levar até 5 dias úteis. Há sandbox separado — peça as credenciais de QA para testes.

Portal do desenvolvedor

Starken▼

Campos necessários: API Token, Cuenta Corriente, RUT

  1. Acesse starken.cl/clientes-empresas e contrate o serviço de encomiendas.
  2. Solicite ao seu executivo comercial o acesso à API v2.
  3. Você receberá um API Token, número de Cuenta Corriente e o RUT cadastrado.

O API Token expira a cada 6 meses — atenção ao prazo de renovação.

Portal do desenvolvedor

Bluexpress (BlueX)▼

Campos necessários: Username, Password, Cuenta Corriente, RUT

  1. Acesse bluex.cl/empresas e contrate o serviço corporativo.
  2. Solicite acesso à API ao seu gerente de contas.
  3. Você receberá Username e Password de API.
  4. O código de Cuenta Corriente aparece no contrato comercial.

O Username/Password da API são diferentes do login do portal web — use os fornecidos especificamente para integração.

Portal do desenvolvedor

Llego.cl▼

Campos necessários: API Key, Store ID

  1. Acesse llego.cl e crie uma conta empresarial.
  2. Em "Integraciones" → "API", clique em "Generar API Key".
  3. Copie a API Key gerada e o Store ID exibido no painel.

A Llego.cl é especializada em same-day e last-mile na Região Metropolitana — confirme cobertura para destinos fora de Santiago.

Portal do desenvolvedor

DHL Express Chile▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com, registre um app e copie a API Key + Account Number.

A mesma conta DHL Developer funciona globalmente — use o Account Number da operação Chile.

Portal do desenvolvedor

FedEx Chile▼

Campos necessários: API Key, Secret Key, Account Number

  1. Acesse developer.fedex.com, crie organização e projeto, copie API Key + Secret Key.
  2. O Account Number é o número da sua conta FedEx Chile (9 dígitos).

Portal do desenvolvedor

🇺🇸 Estados Unidos

USPS▼

Campos necessários: User ID (Client ID), Password (Client Secret)

  1. Acesse usps.com/business/web-tools-apis e registre-se para Web Tools.
  2. Após aprovação, acesse developer.usps.com.
  3. Crie um aplicativo e copie o Client ID (User ID) e Client Secret (Password).

A USPS migrou para a API v3 com OAuth2. Use o Client ID como "User ID" e o Client Secret como "Password".

Portal do desenvolvedor

UPS▼

Campos necessários: API Key, Username, Password, Account Number

  1. Acesse developer.ups.com e registre um aplicativo com as APIs "Rating" e "Shipping".
  2. Copie API Key, Username, Password e Account Number (6 caracteres).

Portal do desenvolvedor

FedEx▼

Campos necessários: API Key, Secret Key, Account Number

  1. Acesse developer.fedex.com, crie projeto, copie API Key + Secret Key + Account Number (9 dígitos).

Portal do desenvolvedor

🇨🇦 Canadá

Canada Post▼

Campos necessários: API Key, API Secret, Customer Number

  1. Acesse o Canada Post Developer Program e registre-se.
  2. Crie uma aplicação no painel de desenvolvedores.
  3. Copie a API Key e API Secret da sua aplicação.
  4. O Customer Number é o número da sua conta comercial Canada Post.

Teste em sandbox primeiro — o ambiente de sandbox tem URLs diferentes que são usadas automaticamente.

Portal do desenvolvedor

Purolator▼

Campos necessários: API Key, Password, Account Number

  1. Acesse purolator.com e contrate o serviço empresarial.
  2. Solicite acesso ao Developer Centre (developer.purolator.com).
  3. Após aprovação, você receberá a Production Key (API Key) e Password.
  4. O Account Number é o número da sua conta Purolator.

Portal do desenvolvedor

UPS Canada▼

Campos necessários: API Key, Username, Password, Account Number

  1. Mesmo processo do UPS global — acesse developer.ups.com.

Portal do desenvolvedor

FedEx Canada▼

Campos necessários: API Key, Secret Key, Account Number

  1. Mesmo processo do FedEx global — acesse developer.fedex.com.

Portal do desenvolvedor

🇪🇸 Espanha

Correos Express▼

Campos necessários: Usuario, Password, Código de Cliente

  1. Contrate o serviço na Correos Express.
  2. Solicite ao seu executivo de contas o acesso à API REST.
  3. Você receberá: Usuario, Password e Código de Cliente (solicitante).

O Código de Cliente é obrigatório para todas as operações de cotação e envio.

Portal do desenvolvedor

SEUR▼

Campos necessários: Client ID, Client Secret, Account Number

  1. Contrate o serviço empresarial na seur.com.
  2. Solicite acesso à API ao seu comercial ou em developers.seur.com.
  3. Registre um aplicativo e copie o Client ID e Client Secret.
  4. O Account Number é o número do seu contrato SEUR.

A SEUR é parte do grupo DPD/Geopost.

Portal do desenvolvedor

DHL Express España▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com, registre app e copie a API Key + Account Number.

Portal do desenvolvedor

UPS España▼

Campos necessários: API Key, Username, Password, Account Number

  1. Mesmo processo UPS global — developer.ups.com.

Portal do desenvolvedor

FedEx España▼

Campos necessários: API Key, Secret Key, Account Number

  1. Mesmo processo FedEx global — developer.fedex.com.

Portal do desenvolvedor

🇵🇹 Portugal

CTT Expresso▼

Campos necessários: Client ID, Client Secret

  1. Acesse ctt.pt/grupo-ctt/api e registre-se como desenvolvedor.
  2. Crie um aplicativo no portal e copie o Client ID e Client Secret.

Os CTT oferecem ambiente de testes — solicite credenciais de sandbox para testar antes de ir a produção.

Portal do desenvolvedor

DHL Parcel Portugal▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com, registre app e copie a API Key + Account Number.

Portal do desenvolvedor

MRW Portugal▼

Campos necessários: Código de Franquicia, Código de Abonado, Username, Password

  1. Contrate o serviço empresarial na mrw.pt.
  2. Solicite ao seu gestor comercial as credenciais do webservice SOAP.
  3. Você receberá: Código de Franquicia, Código de Abonado, Username e Password.

A MRW usa webservice SOAP — confirme com o comercial se as credenciais são para o ambiente correto (teste vs produção).

Portal do desenvolvedor

GLS Portugal▼

Campos necessários: Contact ID, Password

  1. Contrate o serviço na GLS Portugal.
  2. Solicite acesso à API ao seu gestor de conta.
  3. Você receberá o Contact ID e Password para autenticação.

O Contact ID é diferente do número do contrato — confirme com a GLS.

Portal do desenvolvedor

🇮🇹 Itália

Poste Italiane / SDA▼

Campos necessários: Client ID, Client Secret, Codice Contratto

  1. Acesse poste.it/prodotti/api-sda e solicite acesso ao serviço de integração.
  2. Após aprovação, registre um aplicativo para obter Client ID e Client Secret.
  3. Copie também o Codice Contratto fornecido pelo comercial.

O Codice Contratto é obrigatório para gerar etiquetas — sem ele, só a cotação funciona.

Portal do desenvolvedor

DHL Parcel Italy▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com, registre app e copie a API Key + Account Number.

Portal do desenvolvedor

UPS Italy▼

Campos necessários: API Key, Username, Password, Account Number

  1. Mesmo processo UPS global — developer.ups.com.

Portal do desenvolvedor

🇬🇧 Reino Unido

Royal Mail▼

Campos necessários: Client ID, Client Secret, Application ID, Posting Location

  1. Acesse developer.royalmail.net e crie uma conta de desenvolvedor.
  2. Registre um novo aplicativo e copie o Client ID e Client Secret.
  3. Copie o Application ID exibido no painel do aplicativo.
  4. O Posting Location é o código do local de postagem atribuído à sua conta Royal Mail OBA (10 dígitos numéricos).

Consulte seu Account Manager da Royal Mail para obter o Posting Location correto.

Portal do desenvolvedor

DPD UK▼

Campos necessários: Username, Password, Account Number

  1. Acesse o DPD UK Developer Centre e solicite acesso à API.
  2. Após aprovação, você receberá Username e Password de API.
  3. O Account Number é o número da sua conta DPD UK.

O Username/Password da API são diferentes do login do site dpd.co.uk — use os específicos para integração.

Portal do desenvolvedor

DHL Group UK▼

Campos necessários: API Key, Account Number

  1. Acesse developer.dhl.com, registre app e copie a API Key + Account Number.

Portal do desenvolvedor

UPS UK▼

Campos necessários: API Key, Username, Password, Account Number

  1. Mesmo processo UPS global — developer.ups.com.

Portal do desenvolvedor

↩️ Devoluções e logística reversa

Quando o cliente solicita uma devolução e a loja aprova, a Etrovvo gera a etiqueta de logística reversa (coleta no cliente → loja) usando a API reversa da transportadora.

Quem paga: o custo do frete de devolução é do vendedor. A etiqueta é comprada na conta de transporte da Etrovvo e o valor é descontado do seu repasse (lançado como débito e recuperado dos próximos pagamentos).

Depois que o item retorna e é marcado como recebido, a loja processa o reembolso ao cliente — o valor volta pelo mesmo meio de pagamento da compra.

As credenciais são armazenadas de forma segura e criptografada na sua organização. A Etrovvo nunca compartilha ou reutiliza credenciais entre lojas. Todas as chamadas às APIs das transportadoras são feitas diretamente na sua conta — você tem total controle e visibilidade.