Extensão da NF-e

br.dev.bcp.shopping.nfe estende order.

Visão geral

Esta extensão traz uma referência em nível de pedido para um instrumento eletrônico brasileiro emitido. fatura (NF-e): chave de acesso, URL DANFE, URL XML autorizada e carimbo de data/hora da emissão. O modelo da fatura e o protocolo de autorização já estão codificados no acesso chave e XML, para que não sejam duplicados.

Somente a referência viaja no fio. Os dados pessoais do comprador permanecem no sistemas fiscais do vendedor, apoiando a minimização de dados da LGPD e preservando o deveres de retenção fiscal do vendedor.

O bloco é opcional no JSON Schema porque a obrigação de emissão de NF-e depende do regime do vendedor e do tipo de comprador.

Descoberta```json

{ "capabilities": { "br.dev.bcp.shopping.nfe": [ { "version": "2026-07-14", "extends": "br.dev.bcp.shopping.order", "spec": "https://bcp.dev.br/2026-07-14/specification/nfe", "schema": "https://bcp.dev.br/2026-07-14/schemas/shopping/nfe.json" } ] } } ```## Composição do esquema

• order.nfe é um novo objeto opcional somente de resposta.
• Esquema: schemas/shopping/nfe.json.

Campos

Campo	Tipo	Obrigatório	Descrição
access_key	corda	Sim	Chave de acesso da NF-e com 44 dígitos identificando o documento na SEFAZ.
danfe_url	URI	Não	Documento DANFE legível por humanos, geralmente PDF.
xml_url	URI	Não	Documento XML autorizado.
issued_at	data-hora	Não	Emissão de carimbo de data/hora.

Normas Normativas

1. Quando o vendedor é obrigado a emitir uma NF-e, o pedido DEVE receber o Bloco nfe após autorização do documento.
2. O bloco NÃO DEVE conter dados pessoais do comprador. Ele carrega apenas documento referências.
3. Emissão, assinatura, autorização e escrituração contábil são preocupações do lado do vendedor fora do formato de fio de protocolo.

Exemplo

Trecho da resposta do pedido:json { "id": "ord_789", "nfe": { "access_key": "35260519131243000197550010000012341000012349", "danfe_url": "https://notas.example.com.br/danfe/12345.pdf", "xml_url": "https://notas.example.com.br/xml/12345.xml", "issued_at": "2026-07-03T14:30:00-03:00" } }