xPed no item da NF-e: pedido de compra e vínculo B2B

xPed registra o número ou identificador do pedido de compra associado ao item da NF-e. Seu caminho é /nfeProc/NFe/infNFe/det/prod/xPed. É opcional, textual e admite de 1 a 15 caracteres conforme as restrições do schema. O MOC o descreve como informação de interesse do emissor para controle B2B.

Qual pedido o identificador deve representar

Confronte o pedido de compra recebido, a linha fornecida e a identificação usada entre as partes. O número interno de um pedido de venda pode ser diferente do pedido de compra do cliente. Copiar o primeiro número disponível no ERP pode criar um vínculo incorreto para recebimento e conciliação.

O campo também não é número fiscal, chave de acesso, protocolo ou identificação do produto. Um documento autorizado pode ser recusado num processo comercial se o vínculo de pedido estiver ausente ou errado, ainda que a estrutura fiscal tenha passado nas validações. A opcionalidade no XML não elimina uma exigência contratual de integração comprovada entre as partes.

Se a NF-e reúne entregas ligadas a pedidos diferentes, o caminho por item permite associar cada linha ao pedido correspondente. Não repita automaticamente um único identificador em todas as linhas sem conferir a origem. Uma mesma sequência textual pode ser usada por compradores diferentes; o documento e seus participantes continuam necessários à conciliação.

xPed, nItemPed e det/@nItem

xPed identifica o pedido. nItemPed identifica a linha desse pedido e admite numeração própria. det/@nItem é a sequência do item na NF-e. Essas três informações podem ser diferentes: a primeira linha da nota pode atender à linha 37 de um pedido chamado PC-2026-001.

No XML, xPed aparece depois dos campos anteriores de produto, seguido por nItemPed quando informado e por nFCI quando aplicável na sequência do schema. Uma tag chamada xPed em compra, grupo de informações de compras, é outro contexto, com limite de 60 caracteres. O caminho é /nfeProc/NFe/infNFe/compra/xPed, sem ocorrência por item. Esse limite não vale para o xPed de prod. MOC, I60, I61 e ZB03.

Formato e exemplo de conciliação

O identificador deve conservar letras, números e separadores que realmente pertençam ao pedido e sejam admitidos no tipo textual. Zeros iniciais não devem ser apagados por conversão numérica. Uma referência maior que quinze caracteres exige confirmar a identificação utilizada e o contrato da integração; truncá-la silenciosamente pode apontar para outro pedido.

O tipo TString não aceita espaço externo no primeiro ou no último caractere e preserva o texto. Separadores internos reais não devem ser removidos para caber no limite. Caracteres reservados precisam de escape no XML: o pedido fictício PC&026 seria serializado como PC&026, mantendo o identificador interpretado. Uma tag vazia não representa pedido desconhecido; obtenha o vínculo quando ele é exigido pelo contrato comercial.

Fragmento sintético e parcial. A linha 1 da NF-e aponta para a linha 37 de um pedido fictício. Não está pronto para transmissão.

<det xmlns="http://www.portalfiscal.inf.br/nfe" nItem="1">
  <prod>
    <!-- Campos anteriores omitidos -->
    <xPed>PC-2026-001</xPed>
    <nItemPed>37</nItemPed>
  </prod>
  <!-- imposto e demais campos omitidos -->
</det>

O pedido pode se repetir nos itens que realmente o atendem. A repetição não permite deduzir uma linha ausente: nItemPed precisa vir da associação documental específica.

Diagnóstico de pedido ausente ou vínculo errado

Compare o pedido do comprador com o cadastro, o item preparado e o XML. Veja se o integrador usou pedido de venda, número da NF-e, identificador de outra filial ou uma observação genérica que não foi transferida a prod/xPed. Confira limite, texto não vazio e posição da tag para falha estrutural.

Para conciliação, leia xPed e nItemPed juntos e confira quantidades e apresentações do pedido atendido. Não altere a sequência fiscal det/@nItem para imitar a linha comercial. Corrija somente a associação comprovadamente incorreta na origem e confira o XML novo. Não invente um pedido para satisfazer integração, não misture participantes e não edite documento assinado.

Fontes oficiais

• MOC 7.0 — Anexo I — 7.00; p.21 I60/I61; p.64 ZB03.
• Schemas NF-e/NFC-e — PL_010c_NT2022_002v1.30; prod/xPed TString 1–15; compra/xPed 1–60.

Leitura relacionada

• nItemPed: linha do pedido