Maxsul PIED

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-07-10

A Maxsul faz a emissão fiscal no X-Adm e opera a venda de painéis solares na plataforma PIED. Hoje, cada venda fechada na PIED é redigitada à mão no X-Adm — lento, repetitivo e sujeito a erro. Este servidor é o caminho robusto da integração PIED → X-Adm (projeto MAXSUL2025/841): um serviço always-on em pied.maxsul.xadm.biz que captura tudo o que a PIED produz — por webhook (tempo real) e por poll na API REST — e persiste os payloads crus em Postgres.

O MVP faz só isso de propósito. A prioridade é entrar em produção o quanto antes capturando dados reais, para analisar a API da PIED com material de verdade antes de escrever qualquer transformação. A integração com o X-Adm (fase 2) já tem o caminho desenhado — e nasce desligada por toggle de configuração (decisão 0001).

Por que importa

• Dados reais primeiro — cada pedido, cliente e produto da PIED fica registrado cru no banco; a modelagem da fase 2 sai da observação, não de suposição.
• Nada se perde — o webhook aceita qualquer payload (evento inesperado é dado capturado, não erro) e o poll varre as três entidades com cursor incremental persistido.
• Risco mínimo — o serviço não escreve no ERP; ligar/desligar cada mecanismo é uma variável de ambiente (Configuração).

Para o desenho da solução completa (os 4 componentes e o plano em fases), veja a Documentação Completa; os termos do domínio estão no Glossário.