A **API da EnvioXEnvio (ExE)** permite gestionar de forma completa o processo de cotação e contratação de serviços de transporte para os seus envios, tanto a nível nacional como internacional.

### 📦 Funcionalidades principais

- **Tarifas**  
  Criar tarifas imediatas indicando origem, destino e características da carga.  
  Consultar a lista de tarifas criadas ('GET /rates') ou recuperar uma tarifa específica ('GET /rates/{id}').

- **Pedidos**  
  Criar pedidos a partir de uma tarifa ('POST /orders') ou manualmente com todos os dados.  
  Consultar todos os pedidos ou um específico ('GET /orders', 'GET /orders/{id}').

- **Endereços**  
  Gestionar endereços reutilizáveis para recolha ou entrega ('GET', 'POST', 'PUT', 'GET /addresses/{id}').

- **Autenticação**  
  Todas as rotas requerem uma chave de API no header. Pode usar:
  
  - Ambiente de **produção**:
    ```
    x-api-key: SUA_CHAVE_DE_PRODUCAO
    ```

  - Ambiente de **teste**:
    ```
    test-api-key: SUA_CHAVE_DE_TESTE
    ```

  > ⚠️ Não inclua ambas na mesma requisição. Use apenas uma.

---

### 🧪 Ambiente de testes (modo teste)

O modo teste permite testar todas as funcionalidades da API sem afetar seus dados reais.  
Utiliza uma base de dados independente e permite criar tarifas, pedidos e endereços simulados.

Para solicitar uma chave de teste, entre em contacto com a nossa equipe:  
👉 [https://envioxenvio.es/contacto](https://envioxenvio.es/contacto)

---

### 🔧 Dados que compõem uma tarifa

As tarifas são definidas mediante:

- **Origem / Destino**: cidade, código postal, país (formato ISO 3166-1 alpha-2).  
- **Cargas ('loads')**: unidades, dimensões (comprimento, largura, altura), peso, e se é removível.  
- **Extras**: carga lateral, plataforma elevatória (coleta e entrega), mercadoria ADR, envio não transferível...

> ℹ️ A partir da versão **1.0.1**, já **não é necessário enviar** os campos `shipmentType` nem `expressVehicleType`. São calculados automaticamente com base nas cargas.

**Exemplo de criação de tarifa:**

```json
{
  "originPostalCode": "08001",
  "originCountry": "ES",
  "destinationPostalCode": "28001",
  "destinationCountry": "ES",
  "loads": [
    {
      "units": 1,
      "length": 120,
      "width": 100,
      "height": 150,
      "weight": 300,
      "isRemontable": true
    }
  ],
  "pickupTailLift": false,
  "deliveryTailLift": true,
  "isAdr": false,
  "lateralLoad": false,
  "nonTransferable": false,
  "rateType": "rate_by_loads"
}
```

---

### 📘 Histórico de versões

- **v1.0.2** *(actual — 26 de junho de 2025, 13:31)*  
  - Adicionado suporte para modo teste mediante `test-api-key`  
  - Documentado como usar o ambiente de testes sem afetar os dados reais  
  - Melhoria de validações e descrição mais clara

- **v1.0.1** *(25 de junho de 2025, 17:07)*  
  - Eliminados os campos `shipmentType` e `expressVehicleType` do body: agora são calculados automaticamente com base nas cargas

- **v1.0.0** *(8 de junho de 2024, 21:34)*  
  - Versão inicial da API: criação e consulta de tarifas, ordens e endereços

ExE API

Integre a nossa API no seu sistema e comece a desfrutar de todas as vantagens que oferece Envio x Envio. Cotação instantânea, gestão de envios, rastreamento e muito mais.

API da Envio x Envio - A transitária digital da Europa

Referencia da API

Contratação de transporte instantânea para toda a Europa

O que espera?

Ainda não experimentou o nosso calculador de preços instantâneo?

Adaptamo-nos às suas condições de pagamento. Pague por debito domiciliado ou transferência bancária.

FACILIDADE DE PAGAMENTOS

Deixe que os nossos algoritmos e os nossos automatismos trabalhem por si, sem margem de erro.

GESTÃO EXCELENTE

Plantamos 1 árvore para cada envio que realizamos! Assim compensamos as emissões de CO2.

SOMOS VERDES

Obtenha preço para qualquer serviço de transporte terrestre. Sem esperas!

PREÇOS INSTANTÂNEOS

Contamos com uma ampla rede de acordos em toda a Europa, Transitários, Agentes, Armazéns...

GARANTIAS INTERNACIONAIS

Seja qual for a hora ou dia, contrate grupagem internacional de maneira Online, fácil, rápida e segura.

CONTRATAÇÃO SEM ESPERAS

À sua disposição documentos de Entrega, CMR's e Notas de Entrega digitalizados e dispon´veis na sua Área do Cliente.

DOCUMENTAÇÃO ONLINE

Pode consultar a situação e rastreabilidade dos seus envios com total confiabilidade desde a sua Área d Cliente.

RASTREAMENTO ONLINE

Todas as nossas vantagens à sua disposição

Obtenha insights valiosos através de análises de dados avançadas.

Análise de dados

Realize múltiplas cotações de maneira eficiente.

Cotações de forma massiva

Aceda e gestione toda a documentação relacionada com os seus envios.

Documentação, CMRs e PODs

Registe e gestione as suas ordens de carga facilmente.

Registar Ordens de Carga

Obtenha cotações em tempo real para os seus envios.

Cotações Instantâneas

Acompanhe o status e a localização de seus envios em tempo real.

Status de seus envios e rastreamento

Benefícios de integrar nossa API em seu sistema:

Integre com nosso sistema instantâneo de preços de grupagem para toda a Europa, alimentado por IA.