Primeira integração
Da configuração da loja à primeira resposta de frete.
Sua primeira integração usa a capacidade de fretes e cotações. Você fará uma requisição à API REST comum do Meu Ecommerce. Para conectar um agente, siga o guia do Meu Ecommerce MCP.
1. Prepare sua loja
Acesse o painel Meu Ecommerce para criar sua loja ou entrar na conta existente. Configure o CEP de origem, os serviços de envio e o acesso ao plano. O frete precisa dessas configurações para retornar opções válidas.
Obtenha a chave pública da loja (pk_…) pelo fluxo de configuração. Se a credencial não estiver disponível para sua conta, entre em contato com o suporte pelo painel.
Credenciais separadas
2. Faça uma requisição
Defina sua chave no terminal. O valor abaixo é um marcador: substitua pela chave da sua loja.
export MEUECOMMERCE_PUBLIC_KEY='pk_SUA_CHAVE'curl --request POST 'https://api.meuecommerce.com.br/v1/rates' \
--header "Authorization: Bearer $MEUECOMMERCE_PUBLIC_KEY" \
--header 'Content-Type: application/json' \
--data '{
"destinationCep": "20040002",
"items": [{
"name": "Camiseta de algodão",
"quantity": 1,
"unitPriceBRL": 89.90,
"weightKg": 0.3
}]
}'O peso é unitário, em quilogramas. O preço também é unitário, em reais. O CEP de origem vem da configuração da loja.
3. Leia a resposta
Este é um exemplo ilustrativo. Valores, serviços e prazos reais dependem da configuração e da consulta aos Correios.
{
"rates": [
{
"code": "SEDEX",
"serviceId": "correios_sedex",
"label": "SEDEX",
"deliveryDays": 3,
"price": 28.9
}
]
}Uma resposta 200 pode trazer rates: [] e um reason. Trate esse caso como ausência de cotação; não apresente frete grátis por padrão.