PTK API

API do portal de agendamento de coletas e entregas. O fornecedor marca a janela pela web, e o analista transforma o agendamento em coleta dentro do ERP Sankhya.

O problema

O agendamento chegava por e-mail e telefone: o fornecedor pedia uma janela, alguém anotava, e a coleta era aberta no ERP com o que estava na mensagem. Nota repetida em dois agendamentos e data combinada que ninguém registrou eram o resultado normal.

O que ele faz

• Login com o usuário do próprio ERP, e o parceiro vinculado a esse usuário define o que ele enxerga.
• Agendamento de coleta ou entrega com itens, notas fiscais, tipo de mercadoria e tipo de veículo, com criação, edição e listagem filtrada.
• Listas de apoio, como clientes, fornecedores, pagadores, tipos de mercadoria e tipos de veículo, servidas do cadastro do ERP.
• Botão no Sankhya que gera a coleta a partir do agendamento, item a item, e devolve ao analista o erro do ERP quando a criação falha.

Decisões de projeto

A mesma nota fiscal não entra em dois agendamentos: a checagem acontece na criação e devolve conflito com o número da nota, antes de existir coleta duplicada para desfazer.

O perfil do usuário decide a operação, e não a tela: fornecedor cria agendamento, cliente e suporte acompanham. Autorização que vive só na interface é sugestão, não regra.

Código fechado. O projeto roda em ambiente corporativo da Kothe SA.