{"id":247,"date":"2026-09-30T09:00:00","date_gmt":"2026-09-30T09:00:00","guid":{"rendered":"https:\/\/leiritech.pt\/blog\/guia-transporte-codigo-at-whatsapp-erp"},"modified":"2026-09-30T09:00:00","modified_gmt":"2026-09-30T09:00:00","slug":"guia-transporte-codigo-at-whatsapp-erp","status":"publish","type":"post","link":"https:\/\/leiritech.pt\/blog\/guia-transporte-codigo-at-whatsapp-erp","title":{"rendered":"Guia de transporte com c\u00f3digo AT pedida no WhatsApp"},"content":{"rendered":"

S\u00e3o 6h40. O cami\u00e3o est\u00e1 encostado ao cais, as paletes est\u00e3o filmadas e o motorista quer sair \u00e0s 7h para apanhar o cliente de Braga antes do almo\u00e7o. Falta a guia. Quem a emite no ERP \u00e9 a Sandra, da administrativa, que entra \u00e0s 9h. O motorista manda mensagem para o n\u00famero de WhatsApp da empresa e o bot responde, simp\u00e1tico e in\u00fatil: "Para quest\u00f5es de log\u00edstica, por favor contacte o departamento respons\u00e1vel."<\/em><\/p>\n

Ficam tr\u00eas hip\u00f3teses em cima da mesa: esperar duas horas, ligar \u00e0 Sandra para casa ou arrancar sem guia e "resolver depois". Esta \u00faltima \u00e9 a que d\u00e1 problemas, e \u00e9 a que acontece mais vezes do que se admite.<\/p>\n

Porque \u00e9 que "resolver depois" n\u00e3o resolve<\/h2>\n

O regime dos bens em circula\u00e7\u00e3o \u00e9 simples de enunciar: o documento de transporte tem de ser comunicado \u00e0 AT antes<\/strong> de o transporte come\u00e7ar. Quando \u00e9 comunicado a tempo, por webservice a partir do software certificado, a AT devolve um c\u00f3digo de identifica\u00e7\u00e3o, e \u00e9 com esse c\u00f3digo que o motorista circula.<\/p>\n

O pormenor que muita gente s\u00f3 descobre numa opera\u00e7\u00e3o STOP: se comunicares a guia depois<\/em> de a mercadoria ter sa\u00eddo, a AT aceita a comunica\u00e7\u00e3o, mas n\u00e3o atribui c\u00f3digo. O documento existe, mas n\u00e3o prova o que devia provar, porque foi comunicado fora de tempo. N\u00e3o h\u00e1 conversa bonita que corrija isto a posteriori.<\/p>\n

E o problema tem calend\u00e1rio. A Black Week arranca a 23 de novembro, daqui a 54 dias, e a partir da\u00ed as expedi\u00e7\u00f5es n\u00e3o abrandam at\u00e9 ao Natal. Mais cargas, mais cedo, mais sa\u00eddas fora do hor\u00e1rio de quem tem o ERP aberto. O que agora \u00e9 uma chatice ocasional \u00e0s 6h40 passa a ser rotina di\u00e1ria.<\/p>\n

\"Motorista<\/p>\n

O que o bot de \u20ac25 consegue fazer (e n\u00e3o \u00e9 isto)<\/h2>\n

H\u00e1 chatbots para WhatsApp a \u20ac25 por m\u00eas, prontos em "alguns dias", que respondem a partir do site, do cat\u00e1logo e das FAQ. Para dizer o hor\u00e1rio do armaz\u00e9m ou captar um contacto chegam perfeitamente. Mas nenhum deles fala com o teu ERP, e sem ERP n\u00e3o h\u00e1 guia. A resposta "contacte a log\u00edstica" n\u00e3o \u00e9 um defeito de configura\u00e7\u00e3o: \u00e9 tudo o que um sistema desses pode<\/em> dizer, porque n\u00e3o tem acesso a nada que exista na tua opera\u00e7\u00e3o.<\/p>\n

H\u00e1 um segundo limite, e esse \u00e9 legal. Em Portugal, a Portaria 363\/2010 obriga a usar exclusivamente software de fatura\u00e7\u00e3o certificado. Os documentos s\u00e3o assinados com a chave privada do programa, e o programa n\u00e3o pode ter nenhuma fun\u00e7\u00e3o que altere informa\u00e7\u00e3o fiscal sem deixar rasto. Um modelo de linguagem n\u00e3o \u00e9 software certificado. N\u00e3o pode emitir uma guia<\/strong>, nem que queira. O m\u00e1ximo que pode fazer, e \u00e9 exatamente o que deve fazer, \u00e9 pedir<\/em> a guia ao teu ERP certificado, pela API, e devolver o resultado.<\/p>\n

Ou seja, a guia \u00e0s 6h40 n\u00e3o \u00e9 um problema de conversa. \u00c9 um problema de integra\u00e7\u00e3o.<\/p>\n

O mesmo pedido, feito por um agente ligado ao ERP<\/h2>\n

Pega na mesma manh\u00e3. O motorista escreve: "Guia para a encomenda 1432, matr\u00edcula AA-00-BB."<\/em> Eis o que acontece, passo a passo:<\/p>\n

    \n
  1. Identifica\u00e7\u00e3o.<\/strong> O n\u00famero de telefone est\u00e1 associado a um utilizador com permiss\u00e3o para pedir guias de transporte, e s\u00f3 para isso. Um n\u00famero desconhecido n\u00e3o passa daqui.<\/li>\n
  2. Leitura (read-only).<\/strong> O agente l\u00ea a encomenda 1432 no ERP: cliente, NIF, morada de carga e de descarga, artigos, quantidades. Confirma que a encomenda est\u00e1 preparada e que o stock est\u00e1 reservado.<\/li>\n
  3. Pr\u00e9-visualiza\u00e7\u00e3o.<\/strong> Antes de escrever o que quer que seja, devolve o resumo: "Guia para Cliente X, Braga, 12 paletes, 3 artigos, matr\u00edcula AA-00-BB, in\u00edcio \u00e0s 7h00. Confirmas?"<\/em> O motorista confere e responde sim<\/em>.<\/li>\n
  4. Pedido ao ERP.<\/strong> O agente chama a API do ERP (no PHC GO, por exemplo, atrav\u00e9s da Full API, com o respetivo acordo de developer) para criar a guia a partir da encomenda. Quem numera, assina e comunica \u00e0 AT \u00e9 o ERP certificado, n\u00e3o o agente.<\/li>\n
  5. Resposta.<\/strong> O ERP devolve o n\u00famero do documento e o c\u00f3digo AT. O agente envia-os ao motorista, com o PDF da guia em anexo.<\/li>\n
  6. Registo.<\/strong> Fica gravado quem pediu, de que n\u00famero, a que horas, com que par\u00e2metros, que documento foi criado e que c\u00f3digo a AT atribuiu.<\/li>\n<\/ol>\n

    Tudo isto demora menos do que o motorista a apertar o cinto. E a Sandra, quando chega \u00e0s 9h, encontra a guia no ERP como se a tivesse feito ela, com um registo que diz exatamente de onde veio.<\/p>\n

    \"Coordenadora<\/p>\n

    Os detalhes que separam um piloto de um sistema em produ\u00e7\u00e3o<\/h2>\n

    Uma demo faz os seis passos acima num dia bom. A produ\u00e7\u00e3o vive nos dias maus.<\/p>\n

    O motorista envia a mensagem duas vezes.<\/strong> Rede fraca no cais, a mensagem parece n\u00e3o ter ido, ele repete. Um sistema ing\u00e9nuo cria duas guias. O correto \u00e9 o pedido levar uma chave de idempot\u00eancia (encomenda, matr\u00edcula e data): o segundo pedido devolve a guia que j\u00e1 existe, n\u00e3o cria outra.<\/p>\n

    O webservice da AT n\u00e3o responde.<\/strong> Acontece. Aqui \u00e9 onde um chatbot que "adivinha" se torna perigoso: um modelo sem acesso aos dados pode perfeitamente produzir uma sequ\u00eancia de caracteres com cara de c\u00f3digo AT. Um sistema grounded<\/em> s\u00f3 devolve o que o ERP devolveu. Se n\u00e3o h\u00e1 c\u00f3digo, diz "sem c\u00f3digo AT, n\u00e3o arranques"<\/em> e aciona o procedimento de conting\u00eancia que a tua empresa definiu, avisando quem tem de saber.<\/p>\n

    A encomenda n\u00e3o est\u00e1 pronta.<\/strong> Se falta a morada de descarga ou uma linha n\u00e3o tem stock reservado, o agente n\u00e3o inventa nem completa. Para, diz o que falta e a quem pedir.<\/p>\n

    Algu\u00e9m se enganou na matr\u00edcula.<\/strong> A guia \u00e9 um documento do ERP como qualquer outro: a corre\u00e7\u00e3o faz-se l\u00e1, pelo procedimento normal, e o registo mostra a guia original, quem a pediu e o que mudou.<\/p>\n

    Nenhum destes casos tem que ver com "IA". T\u00eam que ver com engenharia de integra\u00e7\u00e3o, e \u00e9 por isso que um agente destes custa entre \u20ac250 e \u20ac1.200 por m\u00eas e um bot de FAQ custa \u20ac25. N\u00e3o est\u00e1s a pagar mais pela conversa. Est\u00e1s a pagar pelo que acontece depois de a conversa acabar.<\/p>\n

    N\u00e3o \u00e9 s\u00f3 no armaz\u00e9m<\/h2>\n

    A mesma l\u00f3gica aparece onde menos se espera.<\/p>\n

    Laborat\u00f3rios de calibra\u00e7\u00e3o.<\/strong> Quando um laborat\u00f3rio devolve ao cliente um lote de instrumentos calibrados (paqu\u00edmetros, man\u00f3metros, blocos-padr\u00e3o), essa mercadoria circula e precisa de documento de transporte. O t\u00e9cnico que embala ao fim do dia raramente \u00e9 quem emite documentos. Num ERP como o Pr\u00fcfMittel, o pedido pode partir da pr\u00f3pria ordem de calibra\u00e7\u00e3o: os instrumentos, o cliente e os certificados j\u00e1 l\u00e1 est\u00e3o.<\/p>\n

    \"T\u00e9cnico<\/p>\n

    Sa\u00fade e lares.<\/strong> O fornecedor que abastece lares de consum\u00edveis e material cl\u00ednico sai cedo e faz v\u00e1rias paragens. Cada paragem \u00e9 uma descarga que tem de estar na guia. Se a rota muda, a altera\u00e7\u00e3o tem de ser feita antes de o transporte come\u00e7ar, e \u00e9 a\u00ed que o pedido pelo WhatsApp ganha tempo.<\/p>\n

    T\u00e9cnicos no terreno.<\/strong> A carrinha do t\u00e9cnico que leva equipamento para instalar tamb\u00e9m transporta bens. A guia pedida no pr\u00f3prio telem\u00f3vel, a partir da ordem de servi\u00e7o, evita a guia em papel preenchida \u00e0 pressa no tablier.<\/p>\n

    As obje\u00e7\u00f5es que ouvimos sempre<\/h2>\n

    "O meu ERP j\u00e1 comunica as guias \u00e0 AT automaticamente."<\/em> \u00d3timo, \u00e9 exatamente isso que queremos. O agente n\u00e3o substitui essa comunica\u00e7\u00e3o; usa-a. O problema nunca foi o ERP comunicar, foi haver algu\u00e9m com o ERP aberto \u00e0s 6h40.<\/p>\n

    "Dou ao motorista acesso ao ERP e pronto."<\/em> Podes, mas pagas mais uma licen\u00e7a, formas uma pessoa que usa o sistema dois minutos por dia e d\u00e1s-lhe um acesso muito mais largo do que precisa. O agente d\u00e1-lhe exatamente uma a\u00e7\u00e3o, e fica tudo registado.<\/p>\n

    "E se o agente fizer asneira?"<\/em> \u00c9 por isso que l\u00ea primeiro, mostra antes de escrever, pede confirma\u00e7\u00e3o e regista tudo. Um agente que escreve no ERP sem pr\u00e9-visualiza\u00e7\u00e3o nem auditoria \u00e9 mesmo uma m\u00e1 ideia, e n\u00e3o \u00e9 isso que estamos a propor.<\/p>\n

    Por onde come\u00e7ar<\/h2>\n

    Faz a conta a uma semana normal de expedi\u00e7\u00e3o: quantas guias foram emitidas fora do hor\u00e1rio de quem tem o ERP aberto, quantas cargas esperaram, quantas sa\u00edram "para resolver depois". Se a resposta for zero, o bot de \u20ac25 serve-te. Se n\u00e3o for, o pr\u00f3ximo passo \u00e9 ver se o teu ERP (PHC, Moloni, InvoiceXpress ou outro) exp\u00f5e a cria\u00e7\u00e3o de guias pela API, e com que permiss\u00f5es.<\/p>\n

    \u00c9 uma conversa de meia hora com quem vai escrever o c\u00f3digo. Fala connosco antes de 23 de novembro: hello@leiritech.com<\/em> ou +351 914 572 595.<\/p>\n","protected":false},"excerpt":{"rendered":"

    Guia comunicada depois de o cami\u00e3o sair fica sem c\u00f3digo AT. V\u00ea como um agente ligado ao ERP a emite \u00e0s 6h40, pelo WhatsApp, auditada e antes de arrancar.<\/p>\n","protected":false},"author":1,"featured_media":244,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[42],"tags":[44,350,349,351,74,352],"class_list":["post-247","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-integracao","tag-agente-ia-erp","tag-comunicacao-guias-de-transporte-at","tag-guia-de-transporte-codigo-at","tag-guia-de-transporte-whatsapp","tag-integracao-erp-whatsapp","tag-phc-go-api-guias"],"_links":{"self":[{"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/posts\/247","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/comments?post=247"}],"version-history":[{"count":0,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/posts\/247\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/media\/244"}],"wp:attachment":[{"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/media?parent=247"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/categories?post=247"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/tags?post=247"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}