> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/tictools-integracoes/outros/shipoffers.md).

# Shipoffers

## Índice

* [Visão geral da integração](#visao-geral-da-integracao)
* [Pré-requisitos](#pre-requisitos)
* [Como obter dados da integração na ShipOffers](#como-gerar-a-api-key-na-shipoffers)
* [Como configurar a integração na Ticto](#como-configurar-a-integracao-na-ticto)
* [Como vincular produtos da Ticto aos produtos da ShipOffers](#como-vincular-produtos-da-ticto-aos-produtos-da-shipoffers)
* [Fluxo de envio dos pedidos](#fluxo-de-envio-dos-pedidos)
* [Como validar a integração](#como-validar-a-integracao)
* [Boas práticas](#boas-praticas)

***

### 🚀 Visão geral da integração

A integração com a **ShipOffers** permite que os pedidos realizados na Ticto sejam enviados automaticamente para a plataforma logística, responsável pelo processo de separação, expedição e envio dos produtos físicos ao comprador.

Após a configuração, sempre que uma venda elegível for aprovada, os dados do pedido poderão ser encaminhados automaticamente para a ShipOffers.

Essa automação reduz falhas operacionais e garante maior agilidade no processo de entrega.

{% hint style="info" %}
A Ticto é responsável pelo envio das informações do pedido. Todo o gerenciamento logístico, atualização de status e rastreamento são realizados diretamente na ShipOffers.
{% endhint %}

O fluxo da integração acontece da seguinte forma:

1. O cliente realiza a compra de um produto físico na Ticto.
2. O pagamento é aprovado.
3. A Ticto envia automaticamente os dados do pedido para a ShipOffers.
4. A ShipOffers recebe o pedido.
5. O processo de separação e expedição é iniciado.
6. O código de rastreio e as atualizações logísticas ficam disponíveis na plataforma da ShipOffers.

{% hint style="info" %}
A integração elimina a necessidade de cadastrar manualmente cada pedido.
{% endhint %}

***

### 📋 Pré-requisitos

Antes de iniciar a configuração, verifique se você possui:

* Conta ativa na Ticto;
* Conta ativa na ShipOffers;
* Produtos previamente cadastrados na ShipOffers;
* Permissão de administrador nas duas plataformas;
* API Key ou Token de integração disponibilizado pela ShipOffers.

{% hint style="warning" %}
A integração somente funcionará corretamente caso os produtos existam nas duas plataformas.
{% endhint %}

***

### 🔑 Como obter dados da Integração na ShipOffers

Para localizar suas credenciais de integração:

1. Faça login na ShipOffers.
2. Acesse o menu **Configurações**.

{% hint style="info" %}
Caso não encontre essa opção, consulte a documentação oficial da ShipOffers ou entre em contato com o suporte da plataforma.
{% endhint %}

***

### 🔗 Como configurar a integração na Ticto

{% stepper %}
{% step %}
Faça login na sua conta da Ticto e no menu lateral, clique em **TICTOOLS.**

<div data-with-frame="true"><figure><img src="/files/TGpMcjJts8lxRg0tNi9C" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<div data-with-frame="true"><figure><img src="/files/lAjxgQpboUy0jOhQTIGd" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<div data-with-frame="true"><figure><img src="/files/C9RhAuGtyAnt6zdzg0Fa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Nova Integração.**

<div data-with-frame="true"><figure><img src="/files/rrEY80rtEkw1DUDXiFSx" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha o campo **Nome** **da Conta**, selecione o **Produto** para integrar e preencha as **informações necessárias do outro software.**

<div data-with-frame="true"><figure><img src="/files/aDegPd3FBqCdKtPUDU3h" alt=""><figcaption></figcaption></figure></div>

Clique em **Salvar**.✅

{% hint style="success" %}
&#x20;A integração será ativada imediatamente após o salvamento.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 📦 Como vincular produtos da Ticto aos produtos da ShipOffers

Após conectar as plataformas, é necessário garantir que os produtos físicos estejam corretamente vinculados.

Para isso:

1. Cadastre o produto na Ticto.
2. Cadastre o mesmo produto na ShipOffers.
3. Utilize a identificação correspondente (SKU, ID ou referência definida pela integração).
4. Salve as configurações.

{% hint style="info" %}
O vínculo correto entre os produtos é essencial para que os pedidos sejam enviados automaticamente.
{% endhint %}

{% hint style="warning" %}
Caso um produto não possua correspondência na ShipOffers, o pedido poderá não ser integrado.
{% endhint %}

***

### 🔄 Fluxo de envio dos pedidos

Após a configuração completa, o fluxo ocorrerá automaticamente.

#### Venda aprovada

Quando uma venda for aprovada na Ticto:

* os dados do comprador são enviados;
* os dados do pedido são enviados;
* os produtos adquiridos são enviados;
* o endereço de entrega é enviado;
* a ShipOffers recebe o pedido automaticamente.

Após isso, toda a operação logística passa a ser administrada pela ShipOffers.

***

### ✅ Como validar a integração

Após finalizar a configuração:

1. Realize uma venda de teste.
2. Aguarde a aprovação do pagamento.
3. Acesse a ShipOffers.
4. Verifique se o pedido foi criado automaticamente.

Caso o pedido apareça normalmente, a integração foi concluída com sucesso.

{% hint style="info" %}
Recomenda-se realizar esse teste antes de iniciar vendas em produção.
{% endhint %}

***

### 💡 Boas práticas

Para garantir uma operação sem falhas:

* mantenha os produtos sincronizados entre as plataformas;
* utilize SKUs únicos para cada produto;
* revise periodicamente a API Key utilizada;
* valide a integração sempre que novos produtos forem cadastrados;
* acompanhe regularmente os pedidos enviados.

{% hint style="success" %}
Uma boa organização do catálogo reduz significativamente falhas na expedição.
{% endhint %}

***