# Correios

## Como Fazer o Cadastro de Frete para Produtos Físicos com a API dos Correios

Com a alteração da API dos Correios, foram realizadas mudanças nos parâmetros de cálculo do frete no envio de produtos físicos. A Ticto lançou uma nova integração com os Correios para melhorar o sistema de cálculo de fretes.

***

### Pré-requisitos

Antes de começar, certifique-se de que você já possui:

* Um **produto físico** cadastrado na Ticto
* As **ofertas** do produto criadas

> 👉 Veja como criar uma oferta de produto físico antes de prosseguir: [ofertas](https://help.ticto.com.br/sou-produtor/meus-produtos/produtor/gerenciamento-e-acoes-em-produtos/ofertas "mention")

***

### Parte 1 — Configurar a Integração com os Correios

#### Acessando a integração

{% stepper %}
{% step %} <sub>Abra o menu lateral esquerdo da plataforma, clique na opção Tictools</sub>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FWEb8VUxjnJuECPwEVpUz%2Fimage.png?alt=media&#x26;token=83bb6194-6767-49c7-8e15-ccc7f274192b" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %} <sub>Dentro de Tictools, clique no card</sub> <sub></sub><sub>**Outros**</sub>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F2i1K7l0eY1yvNG0d9TSR%2Fimage.png?alt=media&#x26;token=5e87b65c-4592-449c-97fd-b6dc7eaec9ca" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Em seguida, selecione a integração dos **Correios.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FXeVgWnTMJsf4mTg8k30o%2Fimage.png?alt=media&#x26;token=3bc08467-5ca5-4e0c-a7f4-3bcb3007e776" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### Criando a integração

{% stepper %}
{% step %}
Na tela dos Correios, clique em Nova Integração.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FcmaeH4P61XAKjtonclDO%2Fimage.png?alt=media&#x26;token=0416629f-5ec7-4959-a0a7-fa8c1c53338e" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha os dados solicitados:

| Campo   | Descrição                            |
| ------- | ------------------------------------ |
| Usuário | Login utilizado no site dos Correios |
| Senha   | Senha utilizada no site dos Correios |

<figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FUXXbEfvBd7zaqMlzVo89%2Fimage.png?alt=media&#x26;token=d2478c0f-1a43-4827-b8c6-910cc2181214" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Clique em Salvar.**

{% endstep %}

{% step %}
Aguarde a mensagem de confirmação: **"Integração Criada com Sucesso"**.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FQT7FGi9hO6vaeDOdZnfA%2Fimage.png?alt=media&#x26;token=a851a214-0bca-4315-9af1-827680a6d660" alt=""><figcaption></figcaption></figure></div>

> 🔑 As credenciais são validadas diretamente via API dos Correios. Use os mesmos dados de acesso do portal correios.com.br.
> {% endstep %}
> {% endstepper %}

***

### Parte 2 — Configurar o Frete por Oferta

Após concluir a integração, é necessário configurar os dados de frete em cada oferta do produto.

`Oferta desejada` → `Dados de Frete`

> **Sempre cadastre um valor de frete padrão.** Caso haja instabilidade nos Correios ou o CEP informado pelo cliente não seja calculável via API, o sistema usará esse valor fixo como fallback.

A plataforma oferece três tipos de frete:

***

#### 🎁 Frete Grátis

Entrega gratuita para todos os estados. O cliente verá apenas essa opção na finalização da compra.

`Oferta` → `Dados de Frete` → `Grátis` → `Prazo de entrega` → `Salvar Dados`

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FBJVIe4XcPe7oTGcXGz8X%2Fimage.png?alt=media&#x26;token=1775b4dd-6704-4617-9f0b-ac7814693665" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FuBWoZM8SMe5cBX6VLsVO%2Fimage.png?alt=media&#x26;token=15596a9f-24b3-4518-b2c6-19793eb29faf" alt=""><figcaption></figcaption></figure></div>

***

#### 🎁 Frete Grátis para X Estados

Frete gratuito apenas para estados selecionados; os demais são calculados normalmente via transportadora.

`Oferta` → `Dados de Frete` → `Transportadora` → `Selecionar estados com frete grátis` → `Transportadora` → `Valor padrão` → `Prazo de entrega` → `Salvar Dados` <br>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2Fhq3uHHVTkkERLxRzunAe%2Fimage.png?alt=media&#x26;token=755836c0-a590-4f92-978e-22d07a348015" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FBaXSejbYFxa0CmEXOCdE%2Fimage.png?alt=media&#x26;token=300ac036-727e-4b18-9027-91e225014bb0" alt=""><figcaption></figcaption></figure>

***

#### 🚚 Transportadora

Cálculo automático via Correios (PAC, SEDEX etc.) com valor fixo de fallback caso o cálculo não esteja disponível.

`Oferta` → `Dados de Frete` → `Transportadora` → `Selecionar transportadora` → `Valor padrão` → `Prazo de entrega` → `Salvar Dados` \ <br>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FGu8kEZK4QcRywhe0ZQsb%2Fimage.png?alt=media&#x26;token=10bb6cc1-02f2-4820-9400-2dda0de15509" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FIfKSitralgQ0QDwj8JqC%2Fimage.png?alt=media&#x26;token=8c085de2-c290-4999-bd39-715ed737455f" alt=""><figcaption></figcaption></figure></div>

***

#### 🔀 Frete Grátis para X Estados + Transportadora

Alguns estados com frete grátis e os demais calculados via transportadora.

`Oferta` → `Dados de Frete` → `Transportadora` → `Selecionar estados com frete grátis` → `Selecionar transportadora` → `Valor padrão` → `Prazo de entrega` → `Salvar Dados`&#x20;

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FGLvHNaffeR0eGDBrOcoF%2Fimage.png?alt=media&#x26;token=eab6374e-81bc-4311-8b38-03ea1d84edd4" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FTWGOgW2iRQk1ne4NSJhX%2Fimage.png?alt=media&#x26;token=9602c7f0-f16a-4d61-b734-ecb1c082523c" alt=""><figcaption></figcaption></figure></div>

***

### Finalizando

Clique em **Salvar Dados** ao concluir a configuração de cada oferta.

> ⚠️ Sempre salve clicando no botão ao final do formulário para que as configurações sejam aplicadas corretamente.

Se tudo estiver certo, seus clientes verão o valor de frete calculado automaticamente no checkout. 🎉