# Consultar envio

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2F5O1fgwy8tJBuxsV6EcSR%2Fimage.png?alt=media&#x26;token=273afa0d-da6a-4704-b936-4e0d7089e3f2" alt="" width="375"><figcaption><p>Parâmetros de configuração.</p></figcaption></figure>

<table><thead><tr><th width="220.66666666666666">Campo</th><th width="135">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>Descrição</td><td>Campo de texto</td><td>Mensagem visual para descrever a função do conector no contexto do fluxo.</td></tr><tr><td><a data-footnote-ref href="#user-content-fn-1">Conta de serviço</a></td><td>Seletor</td><td>Permite o acesso ao sistema através de credenciais fornecidas no painel de contas do Floui.</td></tr><tr><td>ID do envio</td><td>Campo de texto</td><td>Define o código de busca.</td></tr><tr><td>Output path</td><td>Campo de texto</td><td>Armazena os dados de saída do conector ao final da execução.</td></tr></tbody></table>
{% endtab %}

{% tab title="Payload" %}

## Detalhes

O conector Consultar Envio possibilita a recuperação e consulta dos dados de envio de pedidos realizados no e-commerce por meio da API REST.&#x20;

O endpoint utilizado é **GET** `/rest/V1/shipment/{id}`, onde `{id}` corresponde ao identificador único do envio. Para mais informações sobre essa e outras APIs disponíveis no Adobe Commerce Magento, consulte a documentação oficial [REST endpoints (ReDocly)](https://developer.adobe.com/commerce/webapi/rest/quick-reference/).

## Sucesso

Em casos de sucesso, o retorno de execução do conector conterá os dados do envio do pedido realizado no e-commerce.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FdM8in7GBJhAQK8we4e2R%2Fimage.png?alt=media&#x26;token=6985c6c3-8cef-473f-809a-6cb86f059c5c" alt=""><figcaption><p>Sucesso na consulta de envio</p></figcaption></figure>

## Erros

Erros na execução do conector geralmente ocorrem devido à inserção de identificadores inválidos ou em formatos incorretos. Inserir o `increment_id`, visível nas grades do painel administrativo Magento, poderá realizar a consulta para um envio incorreto. Deve-se o usar o identificador da entidade do envio.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2F3grSXLqBsxVizDyL6uYZ%2Fimage.png?alt=media&#x26;token=2253afd6-50d8-482c-be99-c13f4ebd07f0" alt=""><figcaption><p>Erro na consulta do envio.</p></figcaption></figure>
{% endtab %}
{% endtabs %}

[^1]: A conta de serviço precisa ser adicionada no painel de configuração do Floui antes de ser selecionada dentro do componente.
