Administração > Integrações > Documentação das APIs
3156 – API exportação de estoque diário
Através da API exportação de estoque diário o parceiro poderá solicitar a geração de um arquivo CSV com as quantidades de estoque diário de um determinado período e loja.
Parâmetros
- lojaKey: Código da loja que vai exportar o estoque (Obrigatório)
- produtosKeys: Lista de códigos de produtos para exportar (Opcional)
- dataInicial: Data inicial dos estoques a serem exportados (Obrigatório)
- dataFinal: Data final dos estoques a serem exportados (Obrigatório)
- urlDeNotificacao: A url de webhook que será notificada quando a operação finalizar (Obrigatória)
- tipoAutenticacao: Indica se o webhook tem alguma autenticação, atualmente só existe as opções DESABILITADO e HEADER.
- nomeDoHeader: Quando o tipo de autenticação for HEADER, é obrigatório passar o nome do header.
- token: Quando o tipo de autenticação for HEADER, é obrigatório passar o token.
Regras
- Os parâmetros dataInicial e dataFinal não podem ser a data atual;
- Os parâmetros dataInicial e dataFinal não podem ser datas futuras;
- Se a diferença de dias entre a dataInicial e dataFinal for maior que 30 dias, os produtos que possuírem estoque zero ou negativo não serão enviados.
Exemplos de exportação sem especificar produtos
Nesse exemplo vamos simular que o parceiro deseja exportar o estoque diário da loja 4 no dia 27/10/2020.
Ao fim da exportação o ERP notificará o webhook informado com os dados necessários para realizar o download do arquivo gerado:
Com a URL enviada o parceiro usando um token válido, conseguirá gerar uma URL assinada para download do arquivo gerado:
Exemplos de exportação especificando lista de produtos
Nesse exemplo vamos simular que o parceiro deseja exportar o estoque diário da loja 4 no dia 28/10/2020 e produtosKeys 1, 21, 26 e 32.
Ao fim da exportação o ERP notificará o webhook informado com os dados necessários para realizar o download do arquivo gerado:
Com a URL enviada o parceiro usando um token válido, conseguirá gerar uma URL assinada para download do arquivo gerado:
Após o download do arquivo, podemos ver que somente os produtos solicitados foram exportados:
Exemplos de exportação com webhook com autenticação
Nesse exemplo vamos simular que o parceiro deseja exportar o estoque diário da loja 4 no dia 30/10/2020. Além disso o webhook a ser notificado possui autenticação. Nesse caso o tipoAutenticacao dever ser preenchido como HEADER e os campos nomeDoHeader e token devem ser informados.
Como podemos ver na imagem abaixo, foi enviado ao webhook os HEADERS informados no POST:
Ao fim da exportação o ERP notificará o webhook informado com os dados necessários para realizar o download do arquivo gerado:
Com a URL enviada o parceiro usando um token válido, conseguirá gerar uma URL assinada para download do arquivo gerado:
