Criação de API para comparação de estoques
Objetivo
Para utilização da funcionalidade de comparação de estoques via API, o ERP deverá disponibilizar uma API responsável por retornar os dados de estoque dos produtos conforme o padrão definido neste documento. A API deverá retornar as informações de estoque contendo os seguintes campos:
- ERPID
- Empresa
- Layout
- Quantidade
- Lote
- Validade
- Fabricação
Os dados deverão ser retornados em formato texto, separados por ponto e vírgula (;), conforme exemplo abaixo:
ERPID;Empresa;Layout;Quantidade;Lote;Validade;Fabricação
CDO1293712;1;2;102,10;LT123;01/02/2027;01/02/2023
Regras de integração
O ERPID informado pela API deve ser o mesmo identificador utilizado na integração de produtos. A comparação dos estoques será realizada utilizando o conjunto:
O campo Empresa deve corresponder à empresa cadastrada na integração do WMS. Produtos com o mesmo ERPID em empresas diferentes serão considerados registros distintos.
Campos opcionais
Os campos abaixo são opcionais:
- Layout
- Lote
- Validade
- Fabricação
Porém, caso sejam disponibilizados pela API, algumas regras adicionais serão aplicadas durante a comparação. Caso o ERP disponibilize o campo Layout, este deverá ser informado para todos os produtos, pois, a comparação de estoque passará a considerar também o layout do produto:
Caso sejam disponibilizadas as informações de:
- Lote
- Validade
- Fabricação
o estoque será comparado considerando o agrupamento completo:
Dessa forma, produtos com o mesmo ERPId, porém com lotes ou datas diferentes, serão tratados como estoques distintos.
Com a API disponibilizando os dados a aplicação CyberAgent irá executar uma requisição na API em determinado horário e a partir disso será criado um arquivo .csv com as informações retornadas. Com este arquivo será feita a comparação dos estoques.