Atualize suas informações no Canal da Peça diretamente via sistema

Integrações simples disponíveis para qualquer ERP


Como começar?

A integração disponibilizada pelo Canal da Peça é muito simples, ela funciona através de uma comunicação direta entre o seu sistema interno (ERP) e a plataforma do Canal da Peça. Não é preciso nenhuma troca de arquivos, apenas uma comunicação simples e segura através de serviços que ficam disponíveis na WEB, que são denominados API.

O que é uma API?

API é a sigla em inglês para Application Programming Interface ou, em português, Interface de Programação de Aplicativos. Esta interface é o conjunto de padrões de programação que permite a comunicação e a troca de informação entre aplicativos e/ou sistemas.

Quanto Custa?

O Canal da Peça disponibiliza esse serviço de maneira gratuita para todos os seu Distribuidores e Lojistas, você precisará apenas fazer essas adequações no seu sistema interno (ERP).

Sobre API de Serviços

Nossa API de Serviços permite que você possa se comunicar de forma automática e continua para que as informações de estoque e preço estejam sempre atualizadas em nosso banco de dados.

RESTful API

O Canal da Peça disponibiliza uma API RESTful, o que significa que você pode usar uma URL para acessar os diferentes recursos disponíveis como: /products, /stocks, etc.

Segurança

Levamos segurança muito a sério, e por isso você só vai ser capaz de navegar pela API através do protocolo HTTPS em que todas as comunicações são criptografadas, dando total segurança para os seus dados de estoque e preço chegarem apenas ao banco de dados da plataforma do Canal da Peça

Quero Integrar

Para integrar o seu estoque com o Canal da Peça é preciso que você seja uma Loja ou Distribuidor cadastrado na plataforma, caso você ainda não seja cadastrado você pode efetuar o seu cadastro Clicando Aqui!

Caso já tenha um cadastro ativo na plataforma do Canal da Peça você pode solicitar seu usuário para integração enviando um e-mail para: dev@canaldapeca.com.br informando qual é a sua loja.

Como testar?

Você pode realizar testes utilizando a ferramenta Postman, para saber como funciona clique aqui

Documentação

Você poderá consultar a documentação completa da nossa API de Serviços através do link: https://docs.autoreiwebservices.apiary.io/.


Manual de Utilização da API

Como atualizar estoque através da API

Através do serviço de autenticação (1.1), utilize seu clientId e clientSecret que irá retornar o token de acesso para os demais serviços da API.

Exemplo de Autentificação

Consulte o SKU ID do produto que deseja incluir ou atualizar através do serviço Buscar Produto (2.1). Será necessário informar:

  • Marca – brand
  • Composição – composition
  • Código da Peça – partCode

Exemplo de Busca de Produto

Através do serviço de Depósito (3.0) é possível listar, adicionar e atualizar seus depósitos. Caso já possua depósitos cadastrados, utilize o serviço Listar Todos os Depósitos (3.1) para consultar o ID do depósito que deseja utilizar. Caso ainda não possua nenhum depósito cadastrado, utilize o serviço Adicionar Depósito (3.2) informando:

  • Nome do depósito – name
  • CEP do depósito – zipcode

Exemplo de Listar Depósitos Exemplo de Adicionar Depósitos

Ao criar um novo depósito, o serviço retornará o ID do depósito cadastrado.

Com o ID do Produto (SKU ID) e ID do Depósito, é possível Adicionar Novo Estoque (4.1) ou Atualizar um Estoque (4.2).

Para adicionar Novo Estoque. Será necessário informar:

  • ID do Produto (Consultado no item 2.1) – productId
  • ID do Depósito (Consultado no item 3.1) – warehouseId
  • Quantidade em Estoque – quantity
  • Preço – price
  • Quantidade Virtual – virtualQuantity
  • Tempo de Preparo – leadTime
  • Produto Sob Encomenda – byRequest
  • Código da Peça – partCode

Exemplo de Adicionar Estoque

Para atualizar um Estoque. Será necessário informar:

  • ID do Estoque (Criado no item 4.1) – id
  • Quantidade em Estoque – quantity
  • Preço – price
  • Quantidade Virtual – virtualQuantity
  • Tempo de Preparo – leadTime
  • Produto Sob Encomenda – byRequest

Exemplo de Atualizar Estoque