OBJETIVO

Integrar os sistemas Seidor e Ti9, referente aos registros de Clientes, Produtos e Pedidos de Vendas.

UTILIZAÇÃO

Através dos endpoints disponibilizados, as informações pode ser trocadas com o sistema Ti9 usando os métodos HTTP: POST e GET.

O método POST deve ser usado tanto para a inclusão dos registros quanto para a atualização destes. A API recepcionará o JSON enviado via POST. Todos os dados serão validados e caso estejam coerentes, o registro será salvo.

Para os Produtos:

• caso um POST seja realizado em um registro já existente, o mesmo será atualizado com todos os dados do JSON.

Idem para Clientes:

• Neste caso, a resposta do servidor será: 201 - Created, seguida da mensagem que identifica, através de um número, o registro do cliente criado: "Requisição executada com sucesso. Código Pessoa: 007777", onde "007777" é o código do cliente atribuído pelo Ti9.

Já para os Pedidos de Vendas:

• Quando da inserção do pedido de vendas, após validação, todos os dados serão salvos. A resposta do servidor será: 201 - Created, seguida da mensagem que identifica, através de um número, o pedido de vendas criado: “Pedido de vendas adicionado com sucesso! Número (Ti9): 0099999”, onde 0099999 é p número que o Ti9 atribuiu ao pedido criado.
• A partir deste momento, o pedido de vendas fica aguardando a atualização por parte dos sistemas Seidor, das informações de Meios de Pagamento, Peso Líquido, Peso Bruto e Volume.
•  Importante: Devido ao fato de todo o cálculo de peso bruto, líquido e volume serem feitos em outros sistemas, o Ti9 espera receber estas informações. Portanto, estas deve ser recebidas no cabeçalho do JSON como total, isto é, a soma dos pesos e volumes de todos os itens.
• O Ti9 então identifica este pedido com o status "W_UP_FROM_SEIDOR" e bloqueia qualquer tentativa de avanço no fluxo deste pedido de vendas, conforme ilustram as figuras 01 e 02:

Figura 01 - relação dos pedidos. Aqui notamos quatro pedidos que estão com a situação de aguardo de atualizações.

Figura 02 - Pedido de vendas com fluxo bloqueado por ainda estar aguardando as atualizações de Meio de Pagamento, Pesos Líquido e Bruto e Volume.

Vide Interface de Programação de Aplicativos (API) para integração ao ERP Ti9:

Vide manual da API para toda a especificação técnica e uso da mesma: