Visão Geral
Em fevereiro de 2025, publicamos a atualização da integração com ShipSmart conforme API V2. A principal melhoria na etapa de cotação é a exibição automática da lista de países disponíveis para envio diretamente no checkout, sem necessidade de importação da planilha de países no shipping.
Caso prefira manter o comportamento de lista de países por planilha: Habilite a flag "Carregar lista de paises via planilha no checkout internacional" em Admin > Checkout. Abaixo, tem o modelo de planilha para frete internacional. |
Ativação
1. Obter o token de API
Solicite ao seller ou ao consultor da ShipSmart o token de API referente à conta ShipSmart V2.
2. Inserir o token no Admin
Acesse Admin > Configurações > Frete > Integrações, localize a linha ShipSmart V2, clique no ícone Editar e insira o token obtido no passo anterior.
3. Configurar Formas de Entrega
Acesse Admin > Formas de Entrega e realize os seguintes cadastros:
Item | Configuração |
Grupo de Entrega | Cadastre um novo grupo chamado "Internacional" |
Forma de Entrega | Cadastre uma nova forma chamada "Internacional" com:
|
Cadastro de Produtos
Para cotações internacionais, o cadastro do código de barras nos produtos é obrigatório. O campo deve ser preenchido com os 6 primeiros dígitos do código de barras (HS Code).
Habilitar o atributo no Admin
Acesse Admin > Configuração > Atributos e confirme que a flag referente ao código de barras está habilitada.
Preencher o código nos produtos
O seller pode adicionar o campo de duas formas:
Sincronização com ERP da Olist
Importação via planilha de produtos
Etapa de Testes
Teste no frontend da loja
Acesse o front da loja com o parâmetro de idioma na URL:
/?language=en |
Em seguida, localize um produto com cadastro completo, ou seja, com preço internacional e código de barras preenchidos.
Testar a requisição de cotação via API
Importe o cURL abaixo no Postman para validar a integração diretamente com a API da ShipSmart:
curl --location 'https://api.shipsmart.com.br/v2/quotation?level=detailed' \ |
--header 'Accept: application/json' \ |
--header 'Content-Type: application/json' \ |
--header 'Authorization: Bearer <SEU_TOKEN>' \ |
--data '{ |
"object": "not_doc", |
"type": "advanced", |
"tax": "sender", |
"insurance": false, |
"currency_quote": "USD", |
"currency_payment": "USD", |
"address_sender": { "country_code": "BR" }, |
"address_receiver": { "country_code": "US" }, |
"boxes": [{ |
"height": "23.00", |
"width": "16.00", |
"depth": "1.00" |
}], |
"items": [{ |
"box_id": 1, |
"sku": "", |
"name": "Produto Teste", |
"description": "Book", |
"country_code": "BR", |
"hscode": "490199", |
"weight": 10, |
"quantity": 1, |
"unit_value": "104.85" |
}] |
}' |
Substitua <SEU_TOKEN> pelo token de API fornecido pelo seller ou consultor da ShipSmart. |
Referências
Documentação oficial da API V2: api.shipsmart.com.br/doc