Anexo C — Modelagem do envio ao X-Adm (JSON)¶

Informação extraída em 16/06/2026 do documento interno X-Adm (anexos/001 - MAXSUL2025_610110_US.docx), adaptada para o modelo simplificado: como a integração é interna (nós produzimos os dados), o JSON traz apenas a entidade — sem envelope de token/data_hora/operacao/empresa. São três objetos: cliente, produto e pedido.

C.1 Cliente¶

{
  "cnpjCpf": "12345678000109",
  "nomeProp": "Solar Sul Ltda",
  "inscEst": "",
  "endereco": "Rua das Acácias", "numero": "100", "complemento": "",
  "bairro": "Centro", "cidade": "Ponta Grossa", "estado": "PR",
  "cep": "84010000", "cmb": "",
  "telefone": "5642999990000", "email": "joao@solarsul.com"
}

| Campo X-Adm | Origem na PIED | |-------------|----------------| | cnpjCpf | company.cnpj ou company.cpf | | nomeProp | company.companyName | | inscEst | companies.stateInscription (v1) | | endereco/numero/complemento/bairro/cidade/estado/cep | company.address.* | | telefone / email | company.mainContact.cellphone / .email | | cmb | regra X-Adm (de-para de município; não vem da PIED) |

C.2 Produto¶

{ "codigo_produto": "MOD-550", "nomeProd": "Painel Solar 550W Monocristalino", "ean13": "", "temLote": "N" }

| Campo X-Adm | Origem na PIED | |-------------|----------------| | codigo_produto | equipments.productCode | | nomeProd | equipments.name | | ean13 | não consta na PIED (confirmar) | | temLote | regra X-Adm (I/N) |

C.3 Pedido¶

Cabeçalho + itens + parcelas, tudo no mesmo objeto.

{
  "codigo_pedido": "200000123",
  "cnpjCpf": "12345678000109",
  "data": "20260615",
  "tipo_frete": "CIF",
  "antecipado": "S",
  "itens": [ { "codigo_produto": "MOD-550", "quantidade": 10, "valor_unitario": 780.00 } ],
  "pagamento": [ { "prazo": 30 }, { "prazo": 60 } ]
}

| Campo X-Adm | Origem na PIED | |-------------|----------------| | codigo_pedido | request.code | | cnpjCpf | request.company.cnpj | | data | request.orderCreated → AAAAMMDD | | tipo_frete | request.freight.type (CIF/FOB) | | itens[].codigo_produto | products[].productCode | | itens[].quantidade | products[].quantity | | itens[].valor_unitario | products[].singlePrice | | pagamento[].prazo | derivado de request.payment.condition (regra X-Adm) | | antecipado | derivado de request.payment (regra X-Adm) | | cfop (quando aplicável) | regra fiscal X-Adm |

Observações¶

Documentos (cnpjCpf, cep, telefone) em dígitos (sem máscara); datas em AAAAMMDD.
O item referencia o produto pelo codigo_produto (origem) — o X-Adm resolve internamente; não enviamos códigos internos do ERP.
Campos marcados regra X-Adm (cmb, cfop, temLote, antecipado, prazo) ainda estão em definição — ver ../../PENDENCIAS.md.