Copiar página

Não está autenticado. Qualquer mudança que fizer será assinalada como anónimo. You may want to Log In if you already have an account. Também pode Inscrever-se para obter uma nova conta.

<h2>OBJETIVO</h2>Permitir integração customizada, de cadastros e movimentos específicos, com outros sistemas via API (Serviço Web).<h2>PROCESSO</h2>Foi disponibilizada uma API para consultar e incluir dados na base do ERP Ti9 conforme especificado a seguir.<h4>Cadastros para Consulta</h4>- Filiais - Tipos de Operação - Fornecedores - Finalidades - Centros de Custos - Documentos de Entrada - Produtos - Almoxarifados - Grupos de Estoque  <h4>Cadastros para Inclusão:</h4>- Movimentações Internas - Solicitações de Compras <h4>Integração entre o TI9 e o sistema GestorWeb</h4><ul style="list-style-type: square;"><li>A entrada (digitação) das Notas Fiscais será realizada no ERP Ti9. A nota fiscal pode ser considerada disponível para integração ao GestorWeb quando da primeira execução do processo “Efetivação do Estoque” no sistema Ti9;</li><li>Com base nesta disponibilidade, o GestorWeb poderá a seu critério realizar uma requisição à API das Notas Fiscais disponíveis;</li><li>As movimentações de saídas (requisições de consumo) serão realizadas no GestorWeb por rotinas comuns de usuários e haverá integração das saídas no Ti9, o qual validará e gerará uma movimentação de saída para os itens que estiverem marcados com controle de estoque;</li><li>Caso haja entradas de ajustes (inventário ou outros) no GestorWeb, tais movimentações também devem ser integradas ao Ti9 pelo mesmo recurso da integração das saídas;</li><li>Uma vez que o GestorWeb fará o controle de estoque, as demandas de compras baseadas em estoque mínimo e/ou falta de estoque serão gerenciadas por este software, que por sua vez, fará integração com o Ti9, para que gere tais demandas para compras. Os usuários receberão tais demandas como uma solicitação de compras, com status “liberado”, para que apareça diretamente na central de compras, na aba “necessidade”.</li><li>Os cadastros de fornecedor, produtos e empresas (filiais) sempre deverão ser originados no ERP Ti9, que por sua vez, disponibilizará para integração ao GestorWeb. </li></ul>Outras informações importantes para o processo, que não dependem da integração:<ul style="list-style-type: square;"><li>Inicialmente o controle de estoques ocorrerá no GestorWeb, exceto DIESEL que terá estoque controlado em ambos os sistemas;</li><li>Futuramente, outros produtos passarão a ter estoque controlado no TI9 também;</li><li>Estes outros produtos terão que ser cadastrados novamente com novo código no TI9, com o parâmetro de Controla Estoque = SIM;</li><li>O produto anterior que não controla estoque deverá ser inativado;</li><li>O GestorWeb consultará o Cadastro de Produtos e o de Fornecedores regularmente, ou quando necessário;</li><li>Periodicamente consultará as informações de notas de entrada, que serão disponibilizadas pelo Ti9 também;</li><li>O estoque no TI9 deverá aceitar saldos negativos no sentido de não bloquear as Movimentações Internas; um relatório ou WorkFlow deverá indicar os itens com estoque negativo para que o Gestor do Estoque possa realizar os ajustes de inventário necessários;</li><li>As consultas de Fornecedor, Documentos de Entrada e Produtos permitirão filtrar os registros por um período (data inicial e data final) do cadastramento no Ti9.</li></ul><h2>INFORMAÇÕES TÉCNICAS</h2><div><ul style="list-style-type: square;"><li>Processo de autenticação da API: <a class="confluence-link" href="/pages/viewpage.action?pageId=61669435" data-linked-resource-id="61669435" data-linked-resource-type="page" data-linked-resource-default-alias="API TI9 - WebService - Manual de utiliza&amp;ccedil;&amp;atilde;o" data-base-url="http://confluence.ti9.com.br:8081">API TI9 - WebService - Manual de utiliza&ccedil;&atilde;o</a></li><li>Layout de dados para a troca de informações: <a class="confluence-link unresolved" data-filename="Layouts_V4.pdf" data-linked-resource-default-alias="Layouts_V4.pdf" href="#">Layouts_V4</a></li><li>Através dos endpoints disponibilizados, as informações podem ser trocadas com a API via métodos HTTP: POST e GET</li><li>Os dados serão validados e caso estejam coerentes, o registro será salvo</li></ul><h4>Endpoints/URIs para consultas</h4>http://IP:PORTA/erp-api/v4/filiais <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/tipos-operacoes <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/fornecedoreshttp://IP:PORTA/erp-api/v4/fornecedores/filter Body: {&quot;data_inclusao_inicial&quot;: &quot;AAAA-MM-DD&quot;, &quot;data_inclusao_final&quot;: &quot; AAAA-MM-DD &quot;} Exemplo: {&quot;data_inclusao_inicial&quot;: &quot;2019-10-01&quot;, &quot;data_inclusao_final&quot;: &quot;2019-10-31&quot;}http://IP:PORTA/erp-api/v4/finalidades <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/centros-custos <a href="http://IPPORTA" /><s>http://IP:PORTA/erp-api/v4/documentos-entrada</s> <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/documentos-entrada/filter Body: {&quot;data_emissao_inicial&quot;: &quot;AAAA-MM-DD&quot;, &quot;data_emissao_final&quot;: &quot; AAAA-MM-DD &quot;} Exemplo: {&quot;data_emissao_inicial&quot;: &quot;2019-10-01&quot;, &quot;data_emissao_final&quot;: &quot;2019-10-31&quot;}http://IP:PORTA/erp-api/v4/produtos <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/produtos/filter Body: {&quot;data_inclusao_inicial&quot;: &quot;AAAA-MM-DD&quot;, &quot;data_inclusao_final&quot;: &quot; AAAA-MM-DD &quot;} Exemplo: {&quot;data_inclusao_inicial&quot;: &quot;2019-10-01&quot;, &quot;data_inclusao_final&quot;: &quot;2019-10-31&quot;}http://IP:PORTA/erp-api/v4/almoxarifados <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/grupos-estoque Header Authorization: &quot;Bearer &quot; + tokenExemplo: &quot;Bearer eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmcC1hcGkiLCJzdWIiOi...QUxITyJ9.tmIRuyCvb...&quot;Os dados são retornados pela API no formato JSON.Exemplo: URI: http://IP:PORTA/erp-api/v4/tipos-operacoes Response: Status: 200 OK Body (JSON):<img class="confluence-embedded-image image-center" width="500" src="/plugins/servlet/confluence/placeholder/unknown-attachment?locale=pt_PT&amp;version=2" title="tipos-operacoes.png" data-resource-id="PHJpOmF0dGFjaG1lbnQgcmk6ZmlsZW5hbWU9InRpcG9zLW9wZXJhY29lcy5wbmciIC8+">Figura 1 - JSON Tipos de Operações <h4>Endpoints/URIs para inserção</h4>http://IP:PORTA/erp-api/v4/solicitacoes-compras <a href="http://IPPORTA" />http://IP:PORTA/erp-api/v4/movimentacoes-internasHeader Authorization: &quot;Bearer &quot; + tokenExemplo: URI: http://IP:PORTA/erp-api/v4/solicitacoes-compras Body (JSON):<img class="confluence-embedded-image image-center" src="/plugins/servlet/confluence/placeholder/unknown-attachment?locale=pt_PT&amp;version=2" title="solicitacoes-compras.png" data-resource-id="PHJpOmF0dGFjaG1lbnQgcmk6ZmlsZW5hbWU9InNvbGljaXRhY29lcy1jb21wcmFzLnBuZyIgLz4=">Figura 2 - JSON Solicitações de ComprasResponse: Status: 201 Created Body: &quot;Requisição executada com sucesso.&quot; </div>