OBJETIVO
Permitir integração customizada, de cadastros e movimentos específicos, com outros sistemas via API (Serviço Web).
PROCESSO
Foi disponibilizada uma API para consultar e incluir dados na base do ERP Ti9 conforme especificado a seguir.
Cadastros para Consulta
- Filiais
- Tipos de Operação
- Fornecedores
- Finalidades
- Centros de Custos
- Documentos de Entrada
- Produtos
- Almoxarifados
- Grupos de Estoque
Cadastros para Inclusão:
- Movimentações Internas
- Solicitações de Compras
Integração entre o TI9 e o sistema GestorWeb
- 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;
- Com base nesta disponibilidade, o GestorWeb poderá a seu critério realizar uma requisição à API das Notas Fiscais disponíveis;
- 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;
- 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;
- 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”.
- 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.
Outras informações importantes para o processo, que não dependem da integração:
- Inicialmente o controle de estoques ocorrerá no GestorWeb, exceto DIESEL que terá estoque controlado em ambos os sistemas;
- Futuramente, outros produtos passarão a ter estoque controlado no TI9 também;
- Estes outros produtos terão que ser cadastrados novamente com novo código no TI9, com o parâmetro de Controla Estoque = SIM;
- O produto anterior que não controla estoque deverá ser inativado;
- O GestorWeb consultará o Cadastro de Produtos e o de Fornecedores regularmente, ou quando necessário;
- Periodicamente consultará as informações de notas de entrada, que serão disponibilizadas pelo Ti9 também;
- 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;
- 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.
INFORMAÇÕES TÉCNICAS
- Processo de autenticação da API: API TI9 - WebService - Manual de utilização
- Layout de dados para a troca de informações: Layouts_V4
- Através dos endpoints disponibilizados, as informações podem ser trocadas com a API via métodos HTTP: POST e GET
- Os dados serão validados e caso estejam coerentes, o registro será salvo
Endpoints/URIs para consultas
http://IP:PORTA/erp-api/v4/filiais
http://IP:PORTA/erp-api/v4/tipos-operacoes
http://IP:PORTA/erp-api/v4/fornecedores
http://IP:PORTA/erp-api/v4/fornecedores/filter
Body: {"data_inclusao_inicial": "AAAA-MM-DD", "data_inclusao_final": " AAAA-MM-DD "}
Exemplo: {"data_inclusao_inicial": "2019-10-01", "data_inclusao_final": "2019-10-31"}
http://IP:PORTA/erp-api/v4/finalidades
http://IP:PORTA/erp-api/v4/centros-custos
http://IP:PORTA/erp-api/v4/documentos-entrada
http://IP:PORTA/erp-api/v4/documentos-entrada/filter
Body: {"data_emissao_inicial": "AAAA-MM-DD", "data_emissao_final": " AAAA-MM-DD "}
Exemplo: {"data_emissao_inicial": "2019-10-01", "data_emissao_final": "2019-10-31"}
http://IP:PORTA/erp-api/v4/produtos
http://IP:PORTA/erp-api/v4/produtos/filter
Body: {"data_inclusao_inicial": "AAAA-MM-DD", "data_inclusao_final": " AAAA-MM-DD "}
Exemplo: {"data_inclusao_inicial": "2019-10-01", "data_inclusao_final": "2019-10-31"}
http://IP:PORTA/erp-api/v4/almoxarifados
http://IP:PORTA/erp-api/v4/grupos-estoque
Header Authorization:
"Bearer " + token
Exemplo: "Bearer eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmcC1hcGkiLCJzdWIiOi...QUxITyJ9.tmIRuyCvb..."
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):

Figura 1 - JSON Tipos de Operações
Endpoints/URIs para inserção
http://IP:PORTA/erp-api/v4/solicitacoes-compras
http://IP:PORTA/erp-api/v4/movimentacoes-internas
Header Authorization:
"Bearer " + token
Exemplo:
URI: http://IP:PORTA/erp-api/v4/solicitacoes-compras
Body (JSON):

Figura 2 - JSON Solicitações de Compras
Response:
Status: 201 Created
Body: "Requisição executada com sucesso."