A integração com o Marketplace Amaro é feita a partir do nosso usuário API onde o Marketplace busca os produtos para cadastrar no canal de venda.

Também, é utilizado o método de Webhooks para o disparo de atualizações e notificações de novos pedidos.

O que preciso solicitar ao cliente?

Encaminhar para o Marketplace o token da nossa api.

Criando a integração:

Criando usuário API:

Acesse o admin da loja, clique em Configurações > Integrações > API, crie um novo usuário API com o nome Integração Amaro - “nomedoseller”.

Dentro do escopo da integração adicione as autorizações:

Carrinhos;
Clientes;
Pedidos;
Inventários;
Produtos;
Pacotes;
Rastreios;
Pagamentos;
Referências;
Dados de SEO;
Imagens;
Shop Infos;
Inventário;
Estoque;
Variantes.

Após criar o usuário API e receber a chave em seu e-mail envie para o cliente o token da API para cadastro dentro do Marketplace Amaro.

Cadastrando Webhooks:

Para que a integração funcione corretamente precisamos cadastrar as webhooks para atualização de de produtos, pedidos e pacotes.

Acesse o menu Configurações > Integrações > Webhooks e cadastre as Webhooks abaixo:

product-activated -> https://boh-mint-full.amaro.pro/product/vnda?host=urldeproduçãodaloja
stocks-changed -> https://boh-mint-full.amaro.pro/product/vnda/stock?host=urldeproduçãodaloja
prices-changed -> https://boh-mint-full.amaro.pro/product/vnda/price?host=urldeproduçãodaloja
product-changed -> https://boh-mint-full.amaro.pro/product/vnda?host=urldeproduçãodaloja
order-sent -> https://boh-mint-full.amaro.pro/orders/vnda/shippedstatus?host=urldeproduçãodaloja
invoice-created -> https://boh-mint-full.amaro.pro/orders/vnda/invoicestatus?host=urldeproduçãodaloja
package-delivered -> https://boh-mint-full.amaro.pro/orders/vnda/finishedstatus?host=urldeproduçãodaloja
order-canceled -> https://boh-mint-full.amaro.pro/orders/vnda/canceledstatus?host=urldeproduçãodaloja

Mapeamento de forma de entrega:

O mapeamento de forma de entrega por parte da Amaro depende de definirmos como o pedido irá integrar.

Consultar com o seller qual forma de envio será utilizada para enviar os pedidos da Amaro, podemos utilizar apenas uma forma de envio.

Acesse o menu Configurações > Integrações > Mapeamentos.

Clique no (+) e adicione as chaves:

order.shipping_method (utilizar o nome da forma de envio do Shipping)
order.shipping_label (Utilizar nome da forma de envio no pedido dentro dos parênteses)

No campo DE, deve-se preencher com a nomenclatura que deseja mapear e no "PARA" conforme a informação que deseja que entre no admin.

Lembrar de alterar o final da URL para a informar a URL de produção da lojas nos Webhooks cadastrados.