Extensão de Identidade Fiscal¶

br.dev.bcp.shopping.fiscal_identity estende checkout e order.

Visão geral¶

Esta extensão carrega a identidade fiscal de ambas as partes em um país brasileiro transação:

Comprador: CPF ou CNPJ em buyer.tax_id, utilizado quando uma NF-e identificada deve ser emitido.
Vendedor: CNPJ, razão social e endereço em seller_identity, obrigatório para ofertas voltadas ao consumidor, resumos pré-fechamento e recibos no âmbito brasileiro direito do consumidor.

A identidade do vendedor reside dentro da carga útil da transação, não apenas no perfil de descoberta, porque checkouts e pedidos assinados são a compra durável registros. Os perfis são mutáveis e não podem ser mostrados ao consumidor. Congelando o a identidade do vendedor na transação vincula a oferta àquele CNPJ naquele momento.

Descoberta¶

As empresas declaram a capacidade no perfil (/.well-known/ucp). O declaração config PODE transportar dados estáticos de identidade do vendedor usados como linha de base de validação:json { "capabilities": { "br.dev.bcp.shopping.fiscal_identity": [ { "version": "2026-07-14", "extends": ["br.dev.bcp.shopping.checkout", "br.dev.bcp.shopping.order"], "spec": "https://bcp.dev.br/2026-07-14/specification/fiscal-identity", "schema": "https://bcp.dev.br/2026-07-14/schemas/shopping/fiscal_identity.json" } ] } }## Composição do esquema

checkout.buyer é estendido com tax_id.
checkout.seller_identity e order.seller_identity são objetos de nível superior exigido em cada resposta enquanto o recurso estiver ativo.
Esquema: schemas/shopping/fiscal_identity.json.

Campos¶

`tax_id` em `buyer`¶

Campo	Tipo	Obrigatório	Descrição
`kind`	corda aberta	Sim	`cpf` para pessoas físicas ou `cnpj` para pessoas jurídicas.
`value`	corda	Sim	Apenas dígitos: 11 para CPF ou 14 para CNPJ.

`seller_identity` em `checkout` e `order`¶

Campo	Tipo	Obrigatório	Descrição
`cnpj`	corda	Sim	CNPJ do vendedor, 14 dígitos, identificando o emissor da nota fiscal.
`legal_name`	corda	Sim	Nome legal do vendedor.
`address`	`postal_address`	Não	Endereço físico para divulgação ao consumidor.

Normas Normativas¶

seller_identity DEVE estar presente em todos os checkouts e respostas de pedidos enquanto esse recurso estiver ativo.
Os agentes compradores DEVERÃO apresentar o CNPJ e a razão social do vendedor ao consumidor antes da conclusão e no recebimento.
buyer.tax_id DEVE ser recolhido por complete quando a venda exigir um NF-e identificada. Veja NF-e.

Exemplo¶

Trecho da resposta de checkout:json { "id": "chk_123", "buyer": { "first_name": "Ana", "tax_id": { "kind": "cpf", "value": "39053344705" } }, "seller_identity": { "cnpj": "19131243000197", "legal_name": "Loja Exemplo Comercio de Artesanato Ltda" } }