Histórico da Página
...
- Visão Geral
- Exemplo de utilização
- Contratação de uso de API
- Solicitação de credenciais de acesso a API
- Geração de token
- Configuração de parâmetros no sistema
- Utilização da API
01. VISÃO GERAL
Esta documentação tem por objeto explicar o os passos que devem ser seguidos para que possa ser executada uma integração com a Napp Solutions, desde a contratação dos serviços necessários dentro do TOTVS Moda até a consulta que a Napp realizará para obter os dados.
02. EXEMPLO DE UTILIZAÇÃO
Esta integração é utilizada por clientes que necessitam de integrações com a Napp Solutions em seus relacionamentos com Shopping Centersshopping centers.
03. CONTRATAÇÃO DE USO DE API
O primeiro passo a ser tomado é a contratação do serviço de uso de API junto a à TOTVS Moda. Para isso, para isso é necessário realizar contato com o setor comercial ou com seu canal de vendas.
04. SOLICITAÇÃO DE CREDENCIAIS DE ACESSO A API
Deve ser solicitado via e-mail direcionado a criacao@virtualage criacao@virtualage.com.br as credenciais de acesso a à API esta . Essas credenciais permitiram permitirão que as API APIs sejam utilizadas.
05. GERAÇÃO DE TOKEN
De posse das credencias credenciais, deve ser gerado um token que funcionará como uma espécie de chave que permitira executar as , permitindo a execução das requisições nos Endpoints, . Para saber como gerar o token, o material a seguir poderá ser consultado: https://tdn.totvs.com/x/JY27Hw.
06. CONFIGURAÇÃO DE PARÂMETROS NOS SISTEMA
Para a utilização da API "/api/totvsmoda/analytics/v2/branch-sale", é recomendado a marcação de dois parâmetros:
- O primeiro é um parâmetro corporativo, o "NR_DIAS_API_BRANCH-SALE neste ". Neste parâmetro, deve ser informado informada a quantidade máxima de dias que podem ser consultados, levando em consideração a data atual por . Por exemplo: , suponhamos que hoje é dia 15 se . Se no parametro parâmetro for informado o valor 10, a consulta só poderá ser executada entre os dias 5 e 15 porem se tentar . Caso tente filtrar a partir do dia 04, será apresentada uma mensagem informando que a data excede o período permitido.
O segundo
se trata de umparâmetro é específico por empresa
o, chamado "LST_OPER_API_BRANCH-SALE
nele". Nele, é possível informar quais
asoperações devem ser consideradas na consulta
,. Trata-se
tratade uma lista
então, portanto, várias operações podem ser informadas
várias operações. Caso nenhuma operação seja informada, todas as operações
serão Consideradasserão consideradas.
07. UTILIZAÇÃO DA API
Após seguir todos os passos anteriores já , é possível executar uma consulta e receber todos os dados de vendas conforme o filtro por empresa. segue Para visualizar a documentação Swagger da API "sale-branch que pode ser consultada para visualizar documentação swagger da mesma ", você pode consultar o seguinte link: https://tdn.totvs.com/x/BzcELg.