Orquestrador de fretes
API & Integrações
Conecte seu sistema diretamente ao Orquestrador do Carteiro Amigo. Cote, gere etiquetas e rastreie envios via API REST ou receba eventos em tempo real via Webhook.
API REST
Endpoints seguros com autenticação por Bearer Token para cotar, criar envios e rastrear.
Webhooks
Receba notificações em tempo real sobre status de envios diretamente no seu sistema.
Orquestrador
Seleção automática da melhor transportadora disponível para cada rota e volume.
Documentação técnica
POST
https://api.carteiroamigo.com.br/v1/frete/cotarRetorna opções de frete disponíveis para a rota informada.
Request Body
{
"origin_zip": "01310-100",
"destination_zip": "20040-020",
"weight": 1.5,
"height": 15,
"width": 20,
"length": 25,
"declared_value": 150.00,
"quantity": 1
}Response
{
"success": true,
"quote_id": "qt_abc123",
"price": 22.90,
"deadline": "2 a 4 dias úteis",
"service": "Carteiro Amigo Envios"
}Exemplo cURL
curl -X POST \
"https://api.carteiroamigo.com.br/v1/frete/cotar" \
-H "Authorization: Bearer {SEU_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ "origin_zip": "01310-100", "destination_zip": "20040-020", "weight": 1.5, "height": 15, "width": 20, "length": 25, "declared_value": 150.00, "quantity": 1 }'