# (Desenvolvimento) Magento

#### **Documentação e suporte**

- [https://developer.adobe.com/commerce/webapi/rest/quick-reference/](https://developer.adobe.com/commerce/webapi/rest/quick-reference/)
- Suporte Magento; 
    - <span style="color: #ff0000;">Colocar numero aqui</span>
- Tem ambiente de homologação? 
    - <span style="color: #ff0000;">Não</span>

- - - - - -

#### **Autenticação**

- <span style="color: #000000;">[URL API](https://kb.ema.net.br/uploads/images/gallery/2023-11/sDcjyEDa9bylcoXL-configuracaourlapi.png): Informado pelo cliente através da Climba.</span>
- <span style="color: #000000;">Usuario: Informado pelo cliente através da Magento.</span>
- <span style="color: #000000;">Senha: Informado pelo cliente através da Magento.</span>

- - - - - -

#### **O que é sincronizado?**

- Envio de marcas;
- Envio de categorias (grupos);
- Envio de itens;
- Busca de pedidos;
- Busca de clientes.
- Envio de nota fiscal de saída;

- - - - - -

#### **Envio de marcas**

<table border="1" id="bkmrk-endpoint-m%C3%A9todo-bran" style="border-collapse: collapse; width: 43.7034%;"><tbody><tr><td style="width: 31.1111%;"><span style="color: #000000;">**Resource**</span></td><td style="width: 12.5926%;"><span style="color: #000000;">**Método**</span></td></tr><tr><td style="width: 31.1111%;"><span style="color: #000000;">brands</span></td><td style="width: 12.5926%;"><span style="color: #000000;">POST</span></td></tr><tr><td style="width: 31.1111%;"><span style="color: #000000;">brands/&lt;Id da marca na Climba&gt;</span></td><td style="width: 12.5926%;"><span style="color: #000000;">PUT</span></td></tr></tbody></table>

##### <span style="color: #808080;">**Regras para envio**</span>

- - Somente marcas Ativas.
    - <span style="color: #000000;">Somente marcas com o campo ["Exporta para Climba"](https://kb.ema.net.br/uploads/images/gallery/2023-11/yaZMtFAg9OG8zPUV-marcaexportaclimba.png "Exporta para Climba") marcado.</span>
    - Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

##### <span style="color: #808080;">**Opções na Configuração**</span>

- - Se o parâmetro ["Exporta Marcas específicas"](https://kb.ema.net.br/uploads/images/gallery/2023-11/cBAUoMF7wzzR6lPn-configuracaoexportamarca.png) estiver marcado:
        
        
        - Serão enviadas somente as marcas informadas na [aba "Marcas"](https://kb.ema.net.br/uploads/images/gallery/2023-11/IG9sxL4xgqUExkLs-configuracaotabmarca.png).
        - Permite fazer um De/Para das marcas específicas inserindo id da categoria da Climba na coluna ["Cód. E-commerce"](https://kb.ema.net.br/uploads/images/gallery/2023-11/IG9sxL4xgqUExkLs-configuracaotabmarca.png). (Deve ser solicitado para a Climba os IDs)

##### <span style="color: #808080;">**Dados enviados**</span>

<table border="1" id="bkmrk-tag-de-envio-o-que-s" style="border-collapse: collapse; width: 96.7277%; height: 82px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 16.7214%; height: 29px;"><span style="color: #808080;">**Tag de envio**</span>

</td><td class="align-left" style="width: 25.4398%; height: 29px;"><span style="color: #808080;">**O que será enviado**</span>

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 16.7214%; height: 14px;"><span style="color: #0000ff;">**id**</span>

</td><td class="align-left" style="width: 25.4398%; height: 14px;">Id da marca na Climba

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 16.7214%; height: 29px;"><span style="color: #0000ff;">**name**  </span>

</td><td class="align-left" style="width: 25.4398%; height: 29px;">[Descrição da marca](https://kb.ema.net.br/uploads/images/gallery/2023-11/pwqLvjwToChTeUer-marcadescricao.png)

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 16.7214%; height: 10px;"><span style="color: #0000ff;">**description**  </span>

</td><td class="align-left" style="width: 25.4398%; height: 10px;">Null

</td></tr></tbody></table>

##### <span style="color: #808080;">**Tratamento de retorno**</span>

<table border="1" id="bkmrk-opera%C3%A7%C3%A3o-dado-base-d" style="border-collapse: collapse; width: 100%; height: 78px;"><tbody><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">**<span style="color: #808080;">Operação</span>**</td><td style="width: 16.1728%; height: 29px;">**<span style="color: #808080;">Dado</span>**</td><td style="width: 50.4938%; height: 29px;">**<span style="color: #808080;">Base de dados ERP</span>**</td></tr><tr><td style="width: 33.3333%;">Tabela de controle</td><td style="width: 16.1728%;"> </td><td style="width: 50.4938%;">IntegracãoEcommerce\_Marca</td></tr><tr style="height: 10px;"><td style="width: 33.3333%; height: 10px;">Grava no ERP o id da marca na Climba</td><td style="width: 16.1728%; height: 10px;">Id retornado</td><td style="width: 50.4938%; height: 10px;">IntegracaoEcommerce\_Marca.IdMarcaEcommerce</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">Grava/atualiza no ERP a data da ultima sincronização da marca</td><td style="width: 16.1728%; height: 29px;">data e hora atual</td><td style="width: 50.4938%; height: 29px;">IntegracaoEcommerce\_Marca.DataHoraUltimaSinc</td></tr></tbody></table>

- - - - - -

#### **Envio de categorias**

<table border="1" id="bkmrk-endpoint-m%C3%A9todo-cate" style="border-collapse: collapse; width: 50.7395%;"><tbody><tr><td style="width: 36.4198%;"><span style="color: #808080;">**Resource**</span></td><td style="width: 14.3209%;"><span style="color: #808080;">**Método**</span></td></tr><tr><td style="width: 36.4198%;">categories</td><td style="width: 14.3209%;">POST</td></tr><tr><td style="width: 36.4198%;">categories/&lt;Id da categoria na Climba&gt;</td><td style="width: 14.3209%;">PUT</td></tr></tbody></table>

##### <span style="color: #808080;">**Regras para envio**</span>

- - Somente grupos ou catálogos Ativos.
    - <span style="color: #000000;">Somente grupos ou catálogos com o campo ["Exporta para Climba"](https://kb.ema.net.br/llery/2023-11/K9g8hMwMzmWjHVYZ-captura-de-tela-2023-11-07-145804.png) marcado.</span>
    - Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

##### <span style="color: #808080;">**Opções na Configuração**</span>

- - O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.
    - Se o parâmetro "Exporta Grupos específicos" estiver marcado:
        
        
        - Serão enviadas somente os grupos informados na aba "Grupos".
    - Se o parâmetro "Exporta Catálogos específicos" estiver marcado:
        
        
        - - Serão enviadas somente os catálogos informados na aba "Catálogos".
    - Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)

##### <span style="color: #808080;">**Dados enviados**</span>

<table border="1" id="bkmrk-tag-de-envio-o-que-s-0" style="border-collapse: collapse; width: 100.001%; height: 82px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 17.1216%; height: 29px;"><span style="color: #808080;">**Tags de envio**</span>

</td><td class="align-left" style="width: 37.2188%; height: 29px;"><span style="color: #808080;">**O que será enviado**</span>

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 17.1216%; height: 14px;"><span style="color: #0000ff;">**id**</span>

</td><td class="align-left" style="width: 37.2188%; height: 14px;">Id da categoria na Climba

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 17.1216%; height: 29px;">**<span style="color: #0000ff;">parentId</span>**

</td><td class="align-left" style="width: 37.2188%; height: 29px;">Id do grupo ou catalogo pai no ERP

</td></tr><tr><td style="width: 17.1216%;">**<span style="color: #0000ff;">name</span>**

</td><td style="width: 37.2188%;">descrição do grupo ou catálogo

</td></tr><tr><td style="width: 17.1216%;">**<span style="color: #0000ff;">order</span>**

</td><td style="width: 37.2188%;">Classificacao do grupo ou catalogo

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 17.1216%; height: 10px;"><span style="color: #0000ff;">**description**  </span>

</td><td class="align-left" style="width: 37.2188%; height: 10px;">Null

</td></tr></tbody></table>

##### <span style="color: #808080;">**Tratamento de Retorno**</span>

<table border="1" id="bkmrk-opera%C3%A7%C3%A3o-dado-base-d-0" style="border-collapse: collapse; width: 100%; height: 68px;"><tbody><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">**<span style="color: #808080;">Operação</span>**</td><td style="width: 16.1728%; height: 29px;">**<span style="color: #808080;">Dado</span>**</td><td style="width: 50.4938%; height: 29px;">**<span style="color: #808080;">Base de dados ERP</span>**</td></tr><tr><td style="width: 33.3333%;">Tabela de controle</td><td style="width: 16.1728%;"> </td><td style="width: 50.4938%;">IntegracaoEcommerce\_Grupo/IntegracaoEcommerce\_Catalogo</td></tr><tr style="height: 10px;"><td style="width: 33.3333%; height: 10px;">Grava no ERP o id da categoria na Climba</td><td style="width: 16.1728%; height: 10px;">Id retornado</td><td style="width: 50.4938%; height: 10px;">IntegracaoEcommerce\_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce\_Catalogo.IdCatalogoEcommerce</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo</td><td style="width: 16.1728%; height: 29px;">data e hora atual</td><td style="width: 50.4938%; height: 29px;">IntegracaoEcommerce\_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce\_Catalogo.DataHoraUltimaSinc</td></tr></tbody></table>

- - - - - -

#### **Envio de itens simples**

<table border="1" id="bkmrk-endpoint-m%C3%A9todo-prod" style="border-collapse: collapse; width: 50.7395%;"><tbody><tr><td style="width: 36.4198%;"><span style="color: #808080;">**Resource**</span></td><td style="width: 14.3209%;"><span style="color: #808080;">**Método**</span></td></tr><tr><td style="width: 36.4198%;">products</td><td style="width: 14.3209%;">POST</td></tr><tr><td style="width: 36.4198%;">products/&lt;Id do item no ERP&gt;</td><td style="width: 14.3209%;">PUT</td></tr></tbody></table>

##### <span style="color: #808080;">**Regras para envio**</span>

- - <span style="color: #000000;">Somente itens com o campo ["Exporta para Climba"](https://kb.ema.net.br/llery/2023-11/K9g8hMwMzmWjHVYZ-captura-de-tela-2023-11-07-145804.png) marcado.</span>
    - <span style="color: #000000;">Somente itens vinculados a marcas com o campo ["Exporta para Climba"](https://kb.ema.net.br/llery/2023-11/K9g8hMwMzmWjHVYZ-captura-de-tela-2023-11-07-145804.png) marcado.</span>
    - Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).
    - Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um &lt;SKU&gt; na climba com o mesmo &lt;Id do item no ERP&gt;, são enviados os dados para atualização (PUT).

##### <span style="color: #808080;">**Opções na Configuração**</span>

- - **<span style="color: #808080;">SKU</span>:** o campo "SKU do produto" define se o SKU será o iditem ou referencia.
    - **<span style="color: #808080;">Nome</span>:** o campo "Descrição do item" define o campo do item que será enviado. 
        - Descrição, descrição técnica, observação ou complemento
    - **<span style="color: #808080;">Preço</span>:** o campo "Utilizar" define qual o preço que será enviado: 
        - Preço de pauta da filial: deve ser informada a "Filial".
        - Tabela de preço específica: deve ser informada a Tabela de preço" .
    - <span style="color: #808080;">**Estoque**</span>: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque. 
        - O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
        - O campo "% Envio estoque", indica o percentual do estoque que será enviado.
        - Respeita o campo "Qt. Múltiplo" do cadastro do item.

##### <span style="color: #808080;">**Dados enviados**</span>

<table border="1" id="bkmrk-tag-de-envio-o-que-s-1" style="border-collapse: collapse; width: 91.2365%; height: 863px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 13.8694%; height: 29px;"><span style="color: #808080;">**Tags de envio**</span>

</td><td class="align-left" style="width: 36.273%; height: 29px;"><span style="color: #808080;">**O que será enviado**</span>

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 13.8694%; height: 14px;"><span style="color: #0000ff;">**id**</span>

</td><td class="align-left" style="width: 36.273%; height: 14px;">Id do item no ERP

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 13.8694%; height: 29px;"><span style="color: #0000ff;">**status**</span>

</td><td class="align-left" style="width: 36.273%; height: 29px;">Status do item no ERP: 1-Atuvo/0-Inativo

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;">**categories**</span>

</td><td style="width: 36.273%; height: 35px;">Id da climba vinculado ao grupo/catalogo do item

</td></tr><tr style="height: 57px;"><td style="width: 13.8694%; height: 43px;"><span style="color: #0000ff;">**brandId**</span>

</td><td style="width: 36.273%; height: 43px;">Id da climba vinculado a marca do item

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 13.8694%; height: 10px;"><span style="color: #0000ff;">**name**</span>

</td><td class="align-left" style="width: 36.273%; height: 10px;">Descrição, descrição técnica, observação ou complemento

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;">**description**</span>

</td><td style="width: 36.273%; height: 35px;">Observação do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;">**productVariants**</span>

</td><td style="width: 36.273%; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **sku**</span>

</td><td style="width: 36.273%; height: 35px;">Id do item ou referencia

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **internalCode**</span>

</td><td style="width: 36.273%; height: 35px;">Id do item no ERP

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **quantity**</span>

</td><td style="width: 36.273%; height: 35px;">Quantidade em estoque do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **description**</span>

</td><td style="width: 36.273%; height: 35px;">Observação do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **grossWeight**</span>

</td><td style="width: 36.273%; height: 35px;">Peso bruto do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **netWeight**</span>

</td><td style="width: 36.273%; height: 35px;">Peso liquido do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **height**</span>

</td><td style="width: 36.273%; height: 35px;">Altura do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **width**</span>

</td><td style="width: 36.273%; height: 35px;">Largura do item

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **length**</span>

</td><td style="width: 36.273%; height: 35px;">Comprimento do item

</td></tr><tr style="height: 38px;"><td style="width: 13.8694%; height: 38px;"><span style="color: #0000ff;"> **prices**</span></td><td style="width: 36.273%; height: 38px;">-

</td></tr><tr><td style="width: 13.8694%;"><span style="color: #0000ff;"> **priceListId**</span></td><td style="width: 36.273%;">"1"

</td></tr><tr><td style="width: 13.8694%;"><span style="color: #0000ff;"> **price**</span></td><td style="width: 36.273%;">Preço do item

</td></tr><tr><td style="width: 13.8694%;"><span style="color: #0000ff;"> **priceFrom**</span></td><td style="width: 36.273%;">"0"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **attributes**</span></td><td style="width: 36.273%; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **id** </span></td><td style="width: 36.273%; height: 35px;">"1"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **name**</span></td><td style="width: 36.273%; height: 35px;">"U"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **attributeGroupId**</span></td><td style="width: 36.273%; height: 35px;">"1"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **id**</span></td><td style="width: 36.273%; height: 35px;">"1"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **name**</span></td><td style="width: 36.273%; height: 35px;">"U"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **attributeGroupId**</span></td><td style="width: 36.273%; height: 35px;">"2"

</td></tr><tr style="height: 35px;"><td style="width: 13.8694%; height: 35px;"><span style="color: #0000ff;"> **barCode**</span></td><td style="width: 36.273%; height: 35px;">Código de barra do item

</td></tr></tbody></table>

##### <span style="color: #808080;">**Tratamento de Retorno**</span>

<table border="1" id="bkmrk-opera%C3%A7%C3%A3o-dado-base-d-1" style="border-collapse: collapse; width: 100%; height: 68px;"><tbody><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">**<span style="color: #808080;">Operação</span>**</td><td style="width: 16.1728%; height: 29px;">**<span style="color: #808080;">Dado</span>**</td><td style="width: 50.4938%; height: 29px;">**<span style="color: #808080;">Base de dados ERP</span>**</td></tr><tr><td style="width: 33.3333%;">Tabela de controle</td><td style="width: 16.1728%;"> </td><td style="width: 50.4938%;">IntegracaoEcommerce\_Item</td></tr><tr style="height: 10px;"><td style="width: 33.3333%; height: 10px;">Grava no ERP o id do item na Climba</td><td style="width: 16.1728%; height: 10px;">Id retornado</td><td style="width: 50.4938%; height: 10px;">IntegracaoEcommerce\_Item.IdItemEcommerce</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">Grava/atualiza no ERP a data da ultima sincronização do item</td><td style="width: 16.1728%; height: 29px;">data e hora atual</td><td style="width: 50.4938%; height: 29px;">IntegracaoEcommerce\_Item.DataHoraUltimaSinc</td></tr></tbody></table>

##### <span style="color: #000000;">**Envio das fotos do itens simples**</span>

<table border="1" id="bkmrk-endpoint-m%C3%A9todo-prod-0" style="border-collapse: collapse; width: 57.8994%;"><tbody><tr><td style="width: 44.449%;"><span style="color: #808080;">**Resource**</span></td><td style="width: 20.4036%;"><span style="color: #808080;">**Método**</span></td></tr><tr><td style="width: 44.449%;">products/&lt;Id do item no ERP&gt;/pictures</td><td style="width: 20.4036%;">DELETE</td></tr><tr><td style="width: 44.449%;">products/&lt;id do item do ERP&gt;/pictures/base64</td><td style="width: 20.4036%;">POST</td></tr></tbody></table>

##### <span style="color: #808080;">**Regras para envio**</span>

- - Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
    - Parâmetro "Sincroniza fotos" marcado.
    - Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
    - Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

<table border="1" id="bkmrk-tags-de-envio-o-que-" style="border-collapse: collapse; width: 100%; height: 87px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 10.2892%; height: 29px;"><span style="color: #808080;">**Tags de envio**</span>

</td><td class="align-left" style="width: 28.8155%; height: 29px;"><span style="color: #808080;">**O que será enviado**</span>

</td></tr><tr style="height: 29px;"><td style="width: 10.2892%; height: 29px;">**<span style="color: #0000ff;">image</span>**</td><td style="width: 28.8155%; height: 29px;">Foto do item em base64</td></tr><tr style="height: 29px;"><td style="width: 10.2892%; height: 29px;">**<span style="color: #0000ff;">position</span>**</td><td style="width: 28.8155%; height: 29px;">Id da foto do item no ERP</td></tr></tbody></table>

##### <span style="color: #808080;">**Tratamento de Retorno**</span>

<table border="1" id="bkmrk-opera%C3%A7%C3%A3o-dado-base-d-2" style="border-collapse: collapse; width: 100%; height: 58px;"><tbody><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">**<span style="color: #808080;">Operação</span>**</td><td style="width: 16.1728%; height: 29px;">**<span style="color: #808080;">Dado</span>**</td><td style="width: 50.4938%; height: 29px;">**<span style="color: #808080;">Base de dados ERP</span>**</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">Grava/atualiza no ERP a data da ultima sincronização do item</td><td style="width: 16.1728%; height: 29px;">data e hora atual</td><td style="width: 50.4938%; height: 29px;">Item.DataHoraUltimaSincClimbaFoto</td></tr></tbody></table>

#####  

- - - - - -

#### **Busca de pedidos**

##### <span style="color: #808080;">**Regras**</span>

- - Busca somente pedidos em aberto na Climba. (**status = 2)**

##### <span style="color: #808080;">**Opções na Configuração**</span>

- - **Transação:** 
        - <span style="background-color: #ffffff;">Informado no cadastro de E-commerce conforme imagem [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/zSER3yl62xkOMkxI-configuracaopedidotransacao.png)</span>
    - **Filial:**
        - <span style="background-color: #ffffff;">Informado no cadastro de Filial conforme imagem [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/y7w6Cu8qV2PVT0ix-configuracaopedidofilial.png)</span>
    - **Responsável Notificação:**
        - Informa usuário [padrão](https://kb.ema.net.br/uploads/images/gallery/2023-11/PaG4eJ8a4nTS3Whl-configuracaopedidoresponsavel.png) que irá receber notificações dos pedidos criados no ERP.
    - **Método e condições de pagamento:**
        - Fazer De/para dos metodos/condicoes e parcelas da Climba.
        - Informar [padrão](https://kb.ema.net.br/uploads/images/gallery/2023-11/zyAWP8ZygADZG5kX-configuracaopedidometodo.png).
        - Se não tiver nenhum acima informado pega do cliente.
    - **Vendedor:**
        - Informa [padrão](https://kb.ema.net.br/uploads/images/gallery/2023-11/DUyvi05hNTvTterQ-configuracaopedidovendedor.png).
        - Se não tiver nenhum acima pega do cliente.
    - **Transportadora:**
        - Fazer De/para das transportadoras da Climba.
        - Informa [padrão](https://kb.ema.net.br/uploads/images/gallery/2023-11/lkQjbNPrqKHP74q1-configuracaopedidotransp.png).

##### <span style="color: #808080;">**Dados usados para criar o pedido**</span>

<table border="1" id="bkmrk-tag-de-retorno-campo" style="border-collapse: collapse; width: 100.001%; height: 468px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 29.9188%; height: 29px;">**Tag de retorno**

</td><td class="align-left" style="width: 21.1403%; height: 29px;">**Campo correspondente**

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 29.9188%; height: 14px;">**<span style="color: #0000ff;">id</span>**

</td><td class="align-left" style="width: 21.1403%; height: 14px;"><span style="color: #000000;">Id do pedido pda</span>

</td></tr><tr style="height: 57px;"><td style="width: 29.9188%; height: 38px;">**<span style="color: #0000ff;">id</span>**

</td><td style="width: 21.1403%; height: 38px;"><span style="color: #000000;">Numero do pedido</span>

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 29.9188%; height: 29px;">**<span style="color: #0000ff;">customerComment</span>**

</td><td class="align-left" style="width: 21.1403%; height: 29px;">Observação

</td></tr><tr style="height: 57px;"><td style="width: 29.9188%; height: 42px;">**<span style="color: #0000ff;">shippingAddress/state</span>**

</td><td style="width: 21.1403%; height: 42px;">UF de destino

</td></tr><tr style="height: 57px;"><td style="width: 29.9188%; height: 39px;">**<span style="color: #0000ff;">name</span>**

</td><td style="width: 21.1403%; height: 39px;">nome do cliente</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 29.9188%; height: 10px;">**<span style="color: #0000ff;">sourceId</span>**

</td><td class="align-left" style="width: 21.1403%; height: 10px;">id marketplace

</td></tr><tr style="height: 35px;"><td style="width: 29.9188%; height: 35px;">**<span style="color: #0000ff;">totalValue</span>**

</td><td style="width: 21.1403%; height: 35px;">Valor total do pedido

</td></tr><tr style="height: 35px;"><td style="width: 29.9188%; height: 35px;">**<span style="color: #0000ff;">totalValue</span>**

</td><td style="width: 21.1403%; height: 35px;">Valor total dos itens

</td></tr><tr style="height: 35px;"><td style="width: 29.9188%; height: 35px;">**<span style="color: #0000ff;">discountValue</span>**

</td><td style="width: 21.1403%; height: 35px;">Valor do desconto

</td></tr><tr style="height: 35px;"><td style="width: 29.9188%; height: 35px;">**<span style="color: #0000ff;">additionValue</span>**

</td><td style="width: 21.1403%; height: 35px;">Valor do acréscimo

</td></tr><tr style="height: 35px;"><td style="width: 29.9188%; height: 35px;">**<span style="color: #0000ff;">shippingValue</span>**

</td><td style="width: 21.1403%; height: 35px;">Valor do frete

</td></tr><tr style="height: 57px;"><td style="width: 29.9188%; height: 40px;">**<span style="color: #0000ff;">payment/id</span>**

</td><td style="width: 21.1403%; height: 40px;">Id do método de pagto

</td></tr><tr style="height: 57px;"><td style="width: 29.9188%; height: 10px;">**<span style="color: #0000ff;">payment/installmentQuantity</span>**</td><td style="width: 21.1403%; height: 10px;">Parcela do método

</td></tr><tr style="height: 57px;"><td style="width: 29.9188%; height: 42px;">**<span style="color: #0000ff;">shipping/id  
</span>**</td><td style="width: 21.1403%; height: 42px;">Id da transportadora

</td></tr></tbody></table>

#### **Item do pedido**

##### <span style="color: #808080;">**Regras**</span>

- - Somente Itens com SKU correspondente no ERP (iditem ou referencia).

##### <span style="color: #808080;">**Dados usados para criar os itens**</span>

<table border="1" id="bkmrk-tag-de-retorno-campo-0" style="border-collapse: collapse; width: 669px; height: 514px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 188.971px; height: 29px;">**Tag de retorno**

</td><td class="align-left" style="width: 252.995px; height: 29px;">**Campo correspondente**

</td><td class="align-left" style="width: 226.966px; height: 29px;">**Base de dados**

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 188.971px; height: 14px;"><span style="color: #0000ff;">**sequence**</span>

</td><td class="align-left" style="width: 252.995px; height: 14px;"><span style="color: #000000;">sequencial do item no pedido</span>

</td><td class="align-left" style="width: 226.966px; height: 14px;">pedido\_item.sequencial

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">sequence</span>**

</td><td style="width: 252.995px; height: 35px;"><span style="color: #000000;">sequencial do item no pedido</span>

</td><td style="width: 226.966px; height: 35px;">pedido\_item.idpedidoitem

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 188.971px; height: 29px;">**<span style="color: #0000ff;">id</span>**

</td><td class="align-left" style="width: 252.995px; height: 29px;">id do pedido na climba

</td><td class="align-left" style="width: 226.966px; height: 29px;">pedido\_item.idpedidopda

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">sku</span>**

</td><td style="width: 252.995px; height: 35px;">Sku do item na climba</td><td style="width: 226.966px; height: 35px;"></td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">productId</span>**

</td><td style="width: 252.995px; height: 35px;">Id do item no ERP</td><td style="width: 226.966px; height: 35px;"></td></tr><tr style="height: 57px;"><td style="width: 188.971px; height: 39px;">**<span style="color: #0000ff;">quantity</span>**

</td><td style="width: 252.995px; height: 39px;">Quantidade do item</td><td style="width: 226.966px; height: 39px;">pedido\_item.qt

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 188.971px; height: 10px;">**<span style="color: #0000ff;">sellingPrice</span>**

</td><td class="align-left" style="width: 252.995px; height: 10px;">Valor unitario do item

</td><td class="align-left" style="width: 226.966px; height: 10px;">pedido\_item.valor

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">sellingPrice</span>**

</td><td style="width: 252.995px; height: 35px;">Valor de pauta

</td><td style="width: 226.966px; height: 35px;">pedido\_item.valorpauta

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">sellingPrice</span>**

</td><td style="width: 252.995px; height: 35px;">Valor sugerido

</td><td style="width: 226.966px; height: 35px;">pedido\_item.valorsugerido

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">quantity \* sellingPrice</span>**

</td><td style="width: 252.995px; height: 35px;">Valor total do item

</td><td style="width: 226.966px; height: 35px;">pedido\_item.valortotal

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">discountValue</span>**

</td><td style="width: 252.995px; height: 35px;">Valor do desconto

</td><td style="width: 226.966px; height: 35px;">pedido\_item.valordesconto

</td></tr><tr style="height: 57px;"><td style="width: 188.971px; height: 57px;">**<span style="color: #0000ff;">discountValue/quantity \* sellingPrice</span>**

</td><td style="width: 252.995px; height: 57px;">Percentual do desconto

</td><td style="width: 226.966px; height: 57px;">pedido\_item.perc\_desconto

</td></tr><tr style="height: 35px;"><td style="width: 188.971px; height: 35px;">**<span style="color: #0000ff;">additionValue</span>**

</td><td style="width: 252.995px; height: 35px;">Valor de acrescimo

</td><td style="width: 226.966px; height: 35px;">pedido.valoracrescimo

</td></tr><tr style="height: 56px;"><td style="width: 188.971px; height: 56px;">**<span style="color: #0000ff;">additionValue/quantity \* sellingPrice</span>**</td><td style="width: 252.995px; height: 56px;">Percentual de acrescimo

</td><td style="width: 226.966px; height: 56px;">pedido\_item.perc\_acrescimo

</td></tr></tbody></table>

#### **Cliente do pedido**

##### <span style="color: #808080;">**Regras** </span>

- - Insere novo cliente no ERP;
    - Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.
    - Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP.
    - Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

##### <span style="color: #808080;">**Opções na Configuração**</span>

- - Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

##### <span style="color: #808080;">**Dados usados para criar o cliente**</span>

<table border="1" id="bkmrk-tag-de-retorno-campo-1" style="border-collapse: collapse; width: 100%; height: 1110px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 15.3088%; height: 29px;">**Tag de retorno**

</td><td class="align-left" style="width: 32.0987%; height: 29px;">**Campo correspondente**

</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;">**"Cadastrado via Climba"**</span>

</td><td style="width: 32.0987%; height: 35px;">Observação</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**birthDate**</span>

</td><td style="width: 32.0987%; height: 30px;">Data de nascimento</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**id**</span>

</td><td style="width: 32.0987%; height: 30px;">Id do cliente na Climba</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**name**</span>

</td><td style="width: 32.0987%; height: 30px;">Fantasia</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**name**</span>

</td><td style="width: 32.0987%; height: 30px;">Razão</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**gender = "m" ou "f"**</span>

</td><td style="width: 32.0987%; height: 30px;">Sexo</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**email**</span>

</td><td style="width: 32.0987%; height: 30px;">e-mail</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**email**</span>

</td><td style="width: 32.0987%; height: 30px;">e-mail NF-e</td></tr><tr style="height: 30px;"><td style="width: 15.3088%; height: 30px;"><span style="color: #0000ff;">**documents/ type** </span>

</td><td style="width: 32.0987%; height: 30px;">-</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "cpf"**</span>

</td><td style="width: 32.0987%; height: 35px;">- </td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 35px;">CPF</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "cnpj"**</span>

</td><td style="width: 32.0987%; height: 35px;">-</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 35px;">CNPJ</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "ie"**</span>

</td><td style="width: 32.0987%; height: 35px;">-</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 35px;">IE</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "rg"**</span>

</td><td style="width: 32.0987%; height: 35px;"> </td></tr><tr style="height: 36px;"><td style="width: 15.3088%; height: 36px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 36px;">RG</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;">**phones**</span>

</td><td style="width: 32.0987%; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "primary"**</span>

</td><td style="width: 32.0987%; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 35px;">Fone</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "secundary"**</span>

</td><td style="width: 32.0987%; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 35px;">Fone 2</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **type = "others"**</span>

</td><td style="width: 32.0987%; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **number**</span>

</td><td style="width: 32.0987%; height: 35px;">Fax</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;">**shippingAddress**</span>

</td><td style="width: 32.0987%; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **street**</span>

</td><td style="width: 32.0987%; height: 35px;">Endereço</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **streetNumber**</span>

</td><td style="width: 32.0987%; height: 35px;">Número</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **complement**</span>

</td><td style="width: 32.0987%; height: 35px;">Complemento</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **district**</span>

</td><td style="width: 32.0987%; height: 35px;">Bairro</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **state**</span>

</td><td style="width: 32.0987%; height: 35px;">UF</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **zipCode**</span>

</td><td style="width: 32.0987%; height: 35px;">CEP</td></tr><tr style="height: 35px;"><td style="width: 15.3088%; height: 35px;"><span style="color: #0000ff;"> **city**</span>

</td><td style="width: 32.0987%; height: 35px;">Nome da Cidade</td></tr></tbody></table>

- - - - - -

#### **Envio de Nota fiscal**

<table border="1" id="bkmrk-endpoint-m%C3%A9todo-orde" style="border-collapse: collapse; width: 49.8762%;"><tbody><tr><td style="width: 33.9506%;"><span style="color: #808080;">**Resource**</span></td><td style="width: 15.9259%;"><span style="color: #808080;">**Método**</span></td></tr><tr><td style="width: 33.9506%;">orders/&lt;id do pedido pda&gt;/billed</td><td style="width: 15.9259%;">POST</td></tr></tbody></table>

##### <span style="color: #808080;">**Regras** </span>

- - Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
    - Somente Notas fiscais de saída finalizadas (status = 2).

##### <span style="color: #808080;">**Opções na Configuração**</span>

- - Permite fazer De/para do operador logístico da transportadora.

##### <span style="color: #808080;">**Dados enviados**</span>

<table border="1" id="bkmrk-tag-de-envio-o-que-s-4" style="border-collapse: collapse; width: 100.001%; height: 82px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 18.994%; height: 29px;"><span style="color: #808080;">**Tag de envio**</span>

</td><td class="align-left" style="width: 70.8391%; height: 29px;"><span style="color: #808080;">**O que será enviado**</span>

</td></tr><tr style="height: 29px;"><td class="align-left" style="width: 18.994%; height: 14px;"><span style="color: #0000ff;">**number**</span>

</td><td class="align-left" style="width: 70.8391%; height: 14px;">Número da NFS

</td></tr><tr><td style="width: 18.994%;">**<span style="color: #0000ff;">nfeAccessKey</span>**

</td><td style="width: 70.8391%;">Chave eletrônica da NFS

</td></tr><tr><td style="width: 18.994%;">**<span style="color: #0000ff;">xml</span>**

</td><td style="width: 70.8391%;">XML da NFS

</td></tr><tr><td style="width: 18.994%;">**<span style="color: #0000ff;">logisticOperatorId</span>**</td><td style="width: 70.8391%;">Id da Operador logistico informada na configuração. Se não envia vazio.

</td></tr></tbody></table>