# Passos para integrar

## <img src="/files/H2anmiSZr9Ia2uWxGDXn" alt="" data-size="line">Criando uma conta na Shippify

{% hint style="success" %}
Se você já tem uma conta cadastrada, pode seguir para o próximo passo!
{% endhint %}

Criar uma conta conosco não tem custo e pode ser feito através [link](https://dash.shippify.co/companies/signup) preenchendo os dados da sua empresa, e pronto!

Uma vez que você fizer isso, receberá um e-mail com mais informações (Se não receber, por favor entre em contato conosco através do chat em nosso site).&#x20;

Todas as contas da Shippify são criadas com o modelo Pré-pago, o que significa que para criar suas entregas você precisará adquirir créditos na seção de Faturamento (pagamento com cartão de crédito ou transferência). Se precisar de suporte comercial, você pode nos contatar através do nosso site.

<figure><img src="/files/xswulGGlx0cZLKBdd6ox" alt=""><figcaption><p>Creación de una cuenta</p></figcaption></figure>

## <img src="/files/DqtsQAGbjUrB8aKh1DBz" alt="" data-size="line">Criação de galpões/depósitos

As entregas criadas no sistema sempre terão como ponto de coleta um depósito que você deve criar acessando este [link](https://dash.shippify.co/places).

Você precisará preencher todos os dados solicitados e salvar o identificador para usar no próximo passo.

<figure><img src="/files/BkLXvTU8CBhXCUAj4nOZ" alt=""><figcaption></figcaption></figure>

## <img src="/files/0xxTYI8AuNCb9jOWpCby" alt="" data-size="line">Configurando sua conta na Beetrack

Para a criação de entregas em nosso sistema, você precisará configurar uma lista de motoristas. Apenas os pedidos atribuídos a esse motorista serão criados em nosso sistema. O nome e a quantidade são de sua escolha, mas é importante nos informar no próximo passo.&#x20;

O nome deve seguir o seguinte formato: Nome+Contador.&#x20;

Por exemplo, se você quiser configurar 3 motoristas com o nome "SHIPPIFY", então os nomes deles deveriam ser SHIPPIFY1, SHIPPIFY2, SHIPPIFY3. Por padrão, vamos procurar até 10 motoristas com o nome "SHIPPIFY".

## <img src="/files/1TjPj3sWEgdwthTFnStq" alt="" data-size="line">Escolha os estados que deseja atualizar

Na Shippify, temos uma grande variedade de estados dentro do ciclo de vida da entrega e é necessário encontrar o equivalente no Beetrack para que, quando o estado da entrega mudar no Shippify, ele também mude no Beetrack. Além disso, você pode decidir se deseja anexar comprovantes de entrega, como fotos. Isso é comumente feito no estado final de conclusão.

Exemplo:

<table data-full-width="false"><thead><tr><th width="190">Estado na Shippify</th><th width="198">Estado na Beetrack</th><th width="219">SubEstado na Beetrack</th><th width="100" data-type="checkbox">Fotos</th></tr></thead><tbody><tr><td>Completado</td><td>Entregue - id 123</td><td>Entregue à terceiros - id 1234</td><td>true</td></tr><tr><td>Em posso do motorista</td><td>Não entregue  - id 343</td><td>Cliente ausente - id 3846</td><td>false</td></tr><tr><td>Devolvido</td><td>Não entregue - id 343</td><td>Produto com defeito- id 3454</td><td>false</td></tr></tbody></table>

Para conhecer nossos estados disponíveis e seus significados, acesse este link. Se não estiver familiarizado com os IDs dos subestados no Beetrack, você pode consultar em sua [API](https://apidoc.beetrack.com/#api-SubStatus-showSubStatus).

## <img src="/files/xhtjubA3HaAn1Hrb1LsC" alt="" data-size="line">Enviando seu requerimento

Se já decidiu por este tipo de integração, envie um e-mail para `integração.shippify.co`, preenchendo os dados solicitados:

### Campos obrigatórios:&#x20;

**Email da sua empresa na Shippify**: É o endereço de e-mail com o qual você criou sua conta no passo 1.&#x20;

**Token de autenticação do Beetrack:** É a permissão que precisamos para acessar os pedidos dentro da sua conta no Beetrack. Você pode encontrá-lo na sua conta, acessando Configurações -> Configurações Avançadas.&#x20;

**Identificador de galpão/depósito:** É o identificador da bodega que você criou no passo 3, de onde todos os seus pedidos serão originados.&#x20;

**Estados:** Aqui você deve anexar a tabela dos estados e subestados do Beetrack que deseja que o Shippify atualize (passo 4).

### Campos obrigatórios:&#x20;

**Nome do condutor:** Prefixo do condutor no Beetrack ao qual você atribuirá os pedidos que deseja criar no Shippify. Por padrão, é "SHIPPIFY".

**Número de condutores:** Quantidade de condutores que você configurou dentro do Beetrack. Por padrão, são 10.

### Exemplos

<details>

<summary>Solicitação simples</summary>

```
Bom dia,

Desejo integrar os serviços de vocês com minha loja no Beetrack.
Aqui estão os dados necessários:
* Email da minha empresa na Shippify: example@shippify.co
* Token de autenticação do Beetrack: 654287d54ff3XXXXXXXXXXXXXX
* Identificador da Bodega: 123
* Estados: Documento anexo com a tabela do passo 4

Desde já, obrigado.

Atenciosamente,
Name
```

</details>

<details>

<summary>Solicitação avançada</summary>

```
Bom dia,

Desejo integrar os serviços da minha loja com a Beetrack.
Aqui estão os dados necessários:
* Email da minha empresa na Shippify: example@shippify.co
* Token de autenticação do Beetrack: 654287d54ff3XXXXXXXXXXXXXX
* Identificador da Bodega: 123
* Estados: Documento anexo com a tabela do passo 4
* Nome do motorista: Shipp
* Número de motoristas: 3

Desde já, obrigado.

Atenciosamente,
Name
```

</details>

## <img src="/files/xhtjubA3HaAn1Hrb1LsC" alt="" data-size="line">Ativando a integração

Uma vez que o pedido for enviado, é necessário aguardar a confirmação da ativação da integração pela equipe de suporte. A partir desse momento, você poderá observar as entregas sendo criadas na sua conta da Shippify.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.shippify.co/developers/pt/e-commerce/beetrack/passos-para-integrar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.