{"id":169,"date":"2026-09-21T09:00:00","date_gmt":"2026-09-21T09:00:00","guid":{"rendered":"https:\/\/leiritech.pt\/blog\/api-do-phc-nao-e-plug-and-play"},"modified":"2026-09-21T09:00:00","modified_gmt":"2026-09-21T09:00:00","slug":"api-do-phc-nao-e-plug-and-play","status":"publish","type":"post","link":"https:\/\/leiritech.pt\/blog\/api-do-phc-nao-e-plug-and-play","title":{"rendered":"A API do PHC n\u00e3o \u00e9 plug-and-play (e \u00e9 isso que separa)"},"content":{"rendered":"

Algu\u00e9m te vendeu um bot por \u20ac25\/m\u00eas e disse-te que ele "fala com o teu PHC". Tu assinaste, montaste os fluxos no Meta, e depois chegaste \u00e0 parte em que o cliente pergunta "o meu artigo est\u00e1 em stock?" \u2014 e o bot n\u00e3o tem a m\u00ednima ideia. Porque nunca esteve ligado a coisa nenhuma. Estava a adivinhar a partir de um gui\u00e3o que tu escreveste \u00e0 m\u00e3o.<\/p>\n

N\u00e3o \u00e9 m\u00e1 vontade do fornecedor. \u00c9 que a parte dif\u00edcil \u2014 a \u00fanica que interessa \u2014 n\u00e3o est\u00e1 no bot. Est\u00e1 na camada que vai buscar o dado real ao teu ERP. E essa camada, no caso do PHC, n\u00e3o \u00e9 uma caixa de configura\u00e7\u00e3o. \u00c9 trabalho de engenharia.<\/p>\n

\"Administrativa<\/p>\n

"Ligar ao PHC" quer dizer tr\u00eas coisas diferentes<\/h2>\n

O erro come\u00e7a aqui: as pessoas falam de "o PHC" como se fosse um s\u00f3 sistema com uma s\u00f3 porta de entrada. N\u00e3o \u00e9. O que tens em cima da secret\u00e1ria pode ser uma de tr\u00eas realidades muito diferentes, e cada uma muda tudo.<\/p>\n

Se tens PHC CS<\/strong> \u2014 a vers\u00e3o desktop cl\u00e1ssica, a que corre h\u00e1 anos em cima de SQL Server \u2014 n\u00e3o h\u00e1 API REST nenhuma para o bot chamar. O acesso faz-se contra a base de dados, com conhecimento do modelo de dados do PHC: que tabela guarda o stock, como est\u00e3o ligadas as linhas de documento ao cabe\u00e7alho, o que significa cada flag. Ningu\u00e9m configura isto num painel no-code. \u00c9 preciso algu\u00e9m que leia a estrutura, perceba o que \u00e9 seguro tocar, e construa uma camada de leitura por cima.<\/p>\n

Se j\u00e1 passaste para o PHC GO<\/strong> ou PHC ON<\/strong>, na nuvem, existe uma API \u2014 mas o acesso est\u00e1 fechado atr\u00e1s de subscri\u00e7\u00e3o e de aprova\u00e7\u00e3o como Developer Partner da Cegid. Ou seja: n\u00e3o \u00e9 o teu fornecedor de bot de \u20ac25 que abre a torneira num s\u00e1bado \u00e0 tarde. H\u00e1 um processo, credenciais, \u00e2mbitos, e limites. A porta existe, mas est\u00e1 trancada, e a chave n\u00e3o vem na caixa.<\/p>\n

E h\u00e1 o caso h\u00edbrido, o mais comum nas PME portuguesas: PHC antigo em produ\u00e7\u00e3o com uma ou outra liga\u00e7\u00e3o improvisada ao longo dos anos. A\u00ed o trabalho n\u00e3o \u00e9 s\u00f3 t\u00e9cnico, \u00e9 arqueol\u00f3gico.<\/p>\n

O fosso n\u00e3o \u00e9 a conversa. \u00c9 o acesso ao dado.<\/h2>\n

Vale a pena dizer isto sem rodeios, porque \u00e9 a tese toda: a conversa \u00e9 comodidade; a integra\u00e7\u00e3o \u00e9 margem.<\/strong> Qualquer plataforma no-code hoje responde bonito. O modelo de linguagem \u00e9 o mesmo para toda a gente. O que n\u00e3o \u00e9 igual para toda a gente \u00e9 conseguir, de forma fi\u00e1vel e auditada, ir buscar ao PHC o stock daquele artigo, o estado daquela encomenda, o saldo daquele cliente \u2014 e devolv\u00ea-lo sem inventar.<\/p>\n

\"Engenheiro<\/p>\n

\u00c9 por isso que o bot comoditizado a \u20ac25 e o agente ligado ao ERP a \u20ac250\u20131.200\/m\u00eas n\u00e3o s\u00e3o o mesmo produto a pre\u00e7os diferentes. S\u00e3o produtos diferentes. Um vende-te uma caixa de texto simp\u00e1tica. O outro vende-te a camada de acesso \u2014 a parte que ningu\u00e9m consegue clonar num fim de semana, porque exige perceber o teu PHC concreto, com as tuas customiza\u00e7\u00f5es, os teus 15 anos de dados sujos e as tuas regras.<\/p>\n

Um exemplo concreto: "est\u00e1 em stock?"<\/h2>\n

Imagina o pedido mais banal do mundo. Cliente no WhatsApp: "t\u00eam o artigo XPTO-200?"<\/p>\n

O bot de \u20ac25 tem duas sa\u00eddas. Ou responde "vou confirmar e j\u00e1 lhe digo" \u2014 e passa a bola a um humano, exatamente aquilo que devia estar a evitar. Ou pior: inventa um "sim, temos", porque o modelo de linguagem quer ser \u00fatil e n\u00e3o sabe que n\u00e3o sabe. No dia em que esse "sim" \u00e9 falso, perdeste um cliente e ganhaste um problema.<\/p>\n

O agente ligado ao ERP faz outra coisa. Recebe a pergunta, identifica o artigo, consulta o PHC em modo s\u00f3-leitura<\/strong>, l\u00ea a quantidade dispon\u00edvel real e responde "sim, temos 14 unidades em armaz\u00e9m, entrega em 48h". A diferen\u00e7a entre as duas respostas n\u00e3o est\u00e1 na qualidade do portugu\u00eas. Est\u00e1 no facto de uma vir do teu sistema e a outra vir de um palpite.<\/p>\n

\"Operador<\/p>\n

"Mas ent\u00e3o porque \u00e9 read-only? N\u00e3o limita?"<\/h2>\n

\u00c9 a obje\u00e7\u00e3o honesta, e a resposta \u00e9 o contr\u00e1rio do que parece. O acesso s\u00f3-leitura, auditado, n\u00e3o \u00e9 uma limita\u00e7\u00e3o \u2014 \u00e9 o que torna isto instal\u00e1vel num neg\u00f3cio a s\u00e9rio. Um agente que pode escrever<\/em> no teu PHC \u00e9 um agente que pode estragar o teu PHC: lan\u00e7ar um documento errado, alterar um pre\u00e7o, mexer num stock. Ningu\u00e9m respons\u00e1vel liga isso a um modelo de linguagem sem redes.<\/p>\n

Ler, sim. Ler o dado real, com registo de quem perguntou o qu\u00ea e de onde veio a resposta, para que qualquer valor devolvido ao cliente seja rastre\u00e1vel at\u00e9 \u00e0 linha do ERP que o originou. A a\u00e7\u00e3o executada \u2014 quando existe \u2014 passa por regras expl\u00edcitas e caminhos controlados, n\u00e3o por "o modelo decidiu". \u00c9 isto que significa grounded<\/em>: a resposta assenta no teu dado, n\u00e3o na estat\u00edstica do modelo. Um chatbot adivinha a pr\u00f3xima palavra; um agente grounded vai \u00e0 fonte e volta com o n\u00famero.<\/p>\n

O que fazer antes de assinar seja o que for<\/h2>\n

Antes de pagares \u20ac25 ou \u20ac1.200, faz uma pergunta ao fornecedor e ouve com aten\u00e7\u00e3o: "como \u00e9 que exatamente vais ler o meu PHC?"<\/em> Se a resposta for vaga \u2014 "integramos com tudo", "\u00e9 plug-and-play" \u2014 j\u00e1 sabes que n\u00e3o h\u00e1 camada de acesso nenhuma por baixo, s\u00f3 uma caixa de texto. Se a resposta descrever a tua vers\u00e3o do PHC (CS ou GO), o modo de acesso, o read-only e o registo de auditoria, est\u00e1s a falar com quem percebe onde est\u00e1 o trabalho.<\/p>\n

N\u00f3s constru\u00edmos essa camada para PHC e outros ERP, em Leiria, com a equipa que escreve o c\u00f3digo a falar diretamente contigo. Se tens um PHC e queres um assistente que responda a partir do dado real e n\u00e3o de um gui\u00e3o, escreve-nos para hello@leiritech.com<\/strong> ou liga +351 914 572 595<\/strong>. Diz-nos que vers\u00e3o de PHC tens \u2014 \u00e9 por a\u00ed que come\u00e7a a conversa a s\u00e9rio.<\/p>\n","protected":false},"excerpt":{"rendered":"

Um bot de \u20ac25 promete falar com o teu PHC numa tarde. A camada de acesso ao ERP \u00e9 engenharia \u2014 e \u00e9 exatamente a\u00ed que est\u00e1 o fosso. Explicamos porqu\u00ea.<\/p>\n","protected":false},"author":1,"featured_media":166,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[42],"tags":[44,237,132,240,238,239],"class_list":["post-169","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-integracao","tag-agente-ia-erp","tag-api-phc","tag-bot-whatsapp-erp","tag-integracao-erp-portugal","tag-integracao-phc-go","tag-phc-cs-rest"],"_links":{"self":[{"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/posts\/169","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=169"}],"version-history":[{"count":0,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/posts\/169\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/media\/166"}],"wp:attachment":[{"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/media?parent=169"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/categories?post=169"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/leiritech.pt\/blog\/wp-json\/wp\/v2\/tags?post=169"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}