Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use POST /v1/nfe/batch (assíncrono, consultado depois em GET /v1/nfe/queue). Rejeição da SEFAZ volta como 400 com error.erros[] (código e descrição do motivo, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (validação nossa, a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.
Natureza da operação, texto livre (ex.: "VENDA DE MERCADORIA")
serie
integer
Série da NF-e. Ausente = série padrão do emissor
Required range: -9007199254740991 <= x <= 9007199254740991
numero
integer
Número da NF-e (passthrough). Ausente = alocado automaticamente pela engineAPI
Required range: -9007199254740991 <= x <= 9007199254740991
tpNF
integer
Tipo de operação: 0=entrada, 1=saída. Padrão: saída
Required range: -9007199254740991 <= x <= 9007199254740991
idDest
Option 1 · numberOption 2 · numberOption 3 · number
Identificador de local de destino: 1=interna, 2=interestadual, 3=exterior. Ausente: a API deriva do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). A UF do emissor vem do cadastro da empresa. Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes recusam 422 CFOP_IDDEST_DIVERGENTE nomeando os códigos
indFinal
integer
Indica operação com consumidor final: 0=não, 1=sim. Ausente: o motor deriva 1 quando o destinatário é não contribuinte (indicadorIE=9 ou CPF), conforme NT 2016.002 da SEFAZ; nos demais casos vale 0. Informar 0 com destinatário não contribuinte recusa com 422 INDFINAL_INCOERENTE_COM_DESTINATARIO antes de numerar
Required range: -9007199254740991 <= x <= 9007199254740991
indPres
integer
Indicador de presença do comprador: 0=não se aplica, 1=presencial, 2=internet, 3=teleatendimento, etc.
Required range: -9007199254740991 <= x <= 9007199254740991
finNFe
integer
Finalidade da emissão: 1=normal, 2=complementar, 3=ajuste, 4=devolução, 5=nota de crédito, 6=nota de débito. Ausente = 1. As finalidades 2, 3 e 4 exigem "referenciadas" (a nota original): sem o grupo a SEFAZ rejeitaria a nota DEPOIS de consumir o número (cStat 254 na finalidade 2, cStat 321 na 4), então a API recusa com 422 FINALIDADE_SEM_NFREF antes de numerar. As finalidades 3 e 4 exigem ainda "pagamentos" com forma "90" (sem pagamento).
Required range: 1 <= x <= 6
referenciadas
object[]
Documentos fiscais referenciados (grupo NFref do leiaute, máximo 500). Obrigatório em finNFe 2 (complementar), 3 (ajuste) e 4 (devolução): é o que liga a nota nova à original. Em finNFe 2 vale exatamente um
Maximum array length: 500
Show child attributes
procRef
object[]
Processos ou atos concessórios referenciados (grupo procRef das informações adicionais do leiaute, máximo 100). É onde se declara o regime especial, o termo de acordo ou o convênio que ampara o benefício fiscal informado nos itens
Maximum array length: 100
Show child attributes
transporte
object
Dados de transporte. Se enviado, modFrete é obrigatório
Show child attributes
troco
number
Valor do troco em R$, para venda com pagamento em dinheiro (máximo 2 casas decimais)
Required range: x >= 0
cobranca
object
Cobrança a prazo: fatura (numero, valorOriginal, valorDesconto, valorLiquido) sozinha, ou fatura + duplicatas[] (numero, vencimento, valor) juntas. O XSD aceita duplicatas sem fatura (irmãos, minOccurs=0); a API recusa essa combinação antes de numerar, pelas regras nacionais Y01-20 e Y10-10 (422 COBRANCA_INVALIDA). Informativo/financeiro: NÃO altera vNF nem pagamentos (quem fecha o total transmitido continua sendo pagamentos)
Show child attributes
informacoesComplementares
string
Informações complementares de interesse do contribuinte, impressas no DANFE
informacoesFisco
string
Informações adicionais de interesse do fisco
Maximum string length: 2000
resolverTributacao
boolean
Ativa a emissão assistida (Cérebro Fiscal): resolve CSOSN e o grupo IBS/CBS de itens sem tributação manual. Requer plano com fiscalBrain + Issuer.fiscalBrainEnabled
Response
NF-e autorizada pela SEFAZ
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"EngineAPI","description":"Documentação pública da engineAPI: emissão de NF-e, NFC-e, NFS-e e mais, direto na SEFAZ.","colors":{"primary":"#1E56B1","light":"#2D7AF6","dark":"#0F2A5E"},"logo":{"light":"https://mintcdn.com/3xtec/upxot-gn5enp24zf/logo/light.svg?fit=max\u0026auto=format\u0026n=upxot-gn5enp24zf\u0026q=85\u0026s=63aef46d17335e80239cdc40c74322e9","dark":"https://mintcdn.com/3xtec/upxot-gn5enp24zf/logo/dark.svg?fit=max\u0026auto=format\u0026n=upxot-gn5enp24zf\u0026q=85\u0026s=32d8c9d72ff50350091826485812d053"},"favicon":"https://mintcdn.com/3xtec/upxot-gn5enp24zf/favicon.svg?fit=max\u0026auto=format\u0026n=upxot-gn5enp24zf\u0026q=85\u0026s=2710eead1ba540400726bc73e0244b91","api":{"openapi":"openapi.json"},"appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"https://app.engineapi.com.br","label":"App"}],"primary":{"type":"button","label":"Começar grátis","href":"https://app.engineapi.com.br/auth/register"}},"footer":{"links":[{"header":"Produto","items":[{"label":"App","href":"https://app.engineapi.com.br"},{"label":"Começar grátis","href":"https://app.engineapi.com.br/auth/register"}]},{"header":"Suporte","items":[{"label":"suporte@engineapi.com.br","href":"mailto:suporte@engineapi.com.br"}]}]},"search":{"prompt":"Buscar..."},"fonts":{"family":"Inter"},"icons":{"library":"fontawesome"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"3xtec","hasAudioNarration":false,"actualSubdomain":"3xtec","customDomains":["docs.engineapi.com.br"],"gitSource":{"type":"github","owner":"3x-git","repo":"engine-api","deployBranch":"develop","contentDirectory":"apps/docs-mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af7e641474f4586a49700ac","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":121},{"language":"default","tag":"Endpoints","count":113},{"language":"default","tag":"Documentação","count":47},{"language":"default","tag":"NFe","count":22},{"language":"default","tag":"Autenticação","count":21},{"language":"default","tag":"Cérebro Fiscal","count":16},{"language":"default","tag":"Empresas","count":11},{"language":"default","tag":"NFSe","count":11},{"language":"default","tag":"Emissão","count":10},{"language":"default","tag":"Erros e operação","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/nfe/criar-nf-e","slug":"/api-reference/nfe/criar-nf-e","pageMetadata":{"title":"Criar NF-e","description":"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no `status` do envelope (`AUTHORIZED` ou `REJECTED`, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use `POST /v1/nfe/batch` (assíncrono, consultado depois em `GET /v1/nfe/queue`). Rejeição da SEFAZ volta como `400` com `error.erros[]` (código e descrição do motivo, ver [Erros e Rejeições](/guides/errors)); campo inválido no payload também é `400`, mas sem `erros[]` (validação nossa, a nota nunca chega na SEFAZ). Use `Idempotency-Key` para reenviar com segurança em caso de timeout/retry.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe","href":"/api-reference/nfe/criar-nf-e","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no \", _jsx(_components.code, {\n children: \"status\"\n }), \" do envelope (\", _jsx(_components.code, {\n children: \"AUTHORIZED\"\n }), \" ou \", _jsx(_components.code, {\n children: \"REJECTED\"\n }), \", nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use \", _jsx(_components.code, {\n children: \"POST /v1/nfe/batch\"\n }), \" (assíncrono, consultado depois em \", _jsx(_components.code, {\n children: \"GET /v1/nfe/queue\"\n }), \"). Rejeição da SEFAZ volta como \", _jsx(_components.code, {\n children: \"400\"\n }), \" com \", _jsx(_components.code, {\n children: \"error.erros[]\"\n }), \" (código e descrição do motivo, ver \", _jsx(_components.a, {\n href: \"/guides/errors\",\n children: \"Erros e Rejeições\"\n }), \"); campo inválido no payload também é \", _jsx(_components.code, {\n children: \"400\"\n }), \", mas sem \", _jsx(_components.code, {\n children: \"erros[]\"\n }), \" (validação nossa, a nota nunca chega na SEFAZ). Use \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" para reenviar com segurança em caso de timeout/retry.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Criar NF-e","description":"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no `status` do envelope (`AUTHORIZED` ou `REJECTED`, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use `POST /v1/nfe/batch` (assíncrono, consultado depois em `GET /v1/nfe/queue`). Rejeição da SEFAZ volta como `400` com `error.erros[]` (código e descrição do motivo, ver [Erros e Rejeições](/guides/errors)); campo inválido no payload também é `400`, mas sem `erros[]` (validação nossa, a nota nunca chega na SEFAZ). Use `Idempotency-Key` para reenviar com segurança em caso de timeout/retry.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe","href":"/api-reference/nfe/criar-nf-e","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no `status` do envelope (`AUTHORIZED` ou `REJECTED`, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use `POST /v1/nfe/batch` (assíncrono, consultado depois em `GET /v1/nfe/queue`). Rejeição da SEFAZ volta como `400` com `error.erros[]` (código e descrição do motivo, ver [Erros e Rejeições](/guides/errors)); campo inválido no payload também é `400`, mas sem `erros[]` (validação nossa, a nota nunca chega na SEFAZ). Use `Idempotency-Key` para reenviar com segurança em caso de timeout/retry.","operationId":"create","parameters":[],"requestBody":"e125bcb8-465c-492d-b780-4b12bca2ea15","responses":{"201":"7f8138bc-084d-4080-9a02-f3ecf4d68695","400":"0888e0d3-7e37-4e56-861c-bea6c192bc21","422":"409eea0a-6f03-413b-b88d-1ba79161d29e"},"security":["1b6ff726-d7bf-49df-afe9-7a568f1cd3d8","697330c3-7416-4fb3-9df5-6ddae132f63e"],"summary":"Criar NF-e","tags":["NFe"],"method":"post","type":"path","servers":["d8878a6c-d70f-4081-90fd-dba8eecd399b"],"path":"/v1/nfe","baseUrlOptions":["https://api.engineapi.com.br"],"title":"Criar NF-e","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destinatario":{"type":"object","properties":{"cnpjCpf":{"type":"string","minLength":11,"maxLength":14,"description":"CNPJ (14 dígitos) ou CPF (11 dígitos) do destinatário, só números","x-leiaute":{"tag":"CNPJ","tagAlternativa":"CPF","grupo":"dest: Identificação do Destinatário","tamanho":"14 (CNPJ) ou 11 (CPF)","obrigatoriedadeLeiaute":"O","condicao":"O leiaute tem as duas tags em escolha exclusiva: CNPJ para pessoa jurídica (14 dígitos) e CPF para pessoa física (11 dígitos). A engineAPI recebe o documento num campo só e o motor fiscal escolhe a tag pelo tamanho.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest/CNPJ (TCnpj) e /CPF (TCpf)"},"isRequired":true,"uniqueKey":"destinatario.cnpjCpf","typeLabel":"string"},"nome":{"type":"string","minLength":1,"description":"Razão social ou nome completo do destinatário","x-leiaute":{"tag":"xNome","grupo":"dest: Identificação do Destinatário","tamanho":"2-60","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório sempre que o grupo do destinatário é emitido, que na NF-e é sempre. O leiaute o marca como opcional na estrutura pelo mesmo motivo do grupo dest.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest/xNome"},"isRequired":true,"uniqueKey":"destinatario.nome","typeLabel":"string"},"endereco":{"type":"object","properties":{"logradouro":{"type":"string","minLength":1,"description":"Nome da rua/avenida do destinatário","x-leiaute":{"tag":"xLgr","grupo":"enderDest: Endereço do Destinatário","tamanho":"2-60","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/xLgr"},"isRequired":true,"uniqueKey":"destinatario.endereco.logradouro","typeLabel":"string"},"numero":{"type":"string","minLength":1,"description":"Número do endereço (aceita \"S/N\")","x-leiaute":{"tag":"nro","grupo":"enderDest: Endereço do Destinatário","tamanho":"1-60","obrigatoriedadeLeiaute":"O","condicao":"Ausente, a engineAPI escreve \"SN\".","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/nro"},"isRequired":true,"uniqueKey":"destinatario.endereco.numero","typeLabel":"string"},"bairro":{"type":"string","minLength":1,"description":"Bairro do destinatário","x-leiaute":{"tag":"xBairro","grupo":"enderDest: Endereço do Destinatário","tamanho":"2-60","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/xBairro"},"isRequired":true,"uniqueKey":"destinatario.endereco.bairro","typeLabel":"string"},"codigoMunicipio":{"type":"string","minLength":1,"description":"Código IBGE do município (7 dígitos, ex.: \"5208707\" para Goiânia)","x-leiaute":{"tag":"cMun","grupo":"enderDest: Endereço do Destinatário","tamanho":"7","obrigatoriedadeLeiaute":"O","condicao":"Código do município na tabela do IBGE. Para operação com o exterior o leiaute manda informar 9999999.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/cMun (TCodMunIBGE)"},"isRequired":true,"uniqueKey":"destinatario.endereco.codigoMunicipio","typeLabel":"string"},"municipio":{"type":"string","minLength":1,"description":"Nome do município","x-leiaute":{"tag":"xMun","grupo":"enderDest: Endereço do Destinatário","tamanho":"2-60","obrigatoriedadeLeiaute":"O","condicao":"Para operação com o exterior o leiaute manda informar EXTERIOR.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/xMun"},"isRequired":true,"uniqueKey":"destinatario.endereco.municipio","typeLabel":"string"},"uf":{"type":"string","minLength":2,"maxLength":2,"description":"Sigla da UF, 2 letras maiúsculas (ex.: \"GO\", \"SP\")","x-leiaute":{"tag":"UF","grupo":"enderDest: Endereço do Destinatário","tamanho":"2","obrigatoriedadeLeiaute":"O","valores":[{"valor":"AC","significado":"Unidade federativa AC"},{"valor":"AL","significado":"Unidade federativa AL"},{"valor":"AM","significado":"Unidade federativa AM"},{"valor":"AP","significado":"Unidade federativa AP"},{"valor":"BA","significado":"Unidade federativa BA"},{"valor":"CE","significado":"Unidade federativa CE"},{"valor":"DF","significado":"Unidade federativa DF"},{"valor":"ES","significado":"Unidade federativa ES"},{"valor":"GO","significado":"Unidade federativa GO"},{"valor":"MA","significado":"Unidade federativa MA"},{"valor":"MG","significado":"Unidade federativa MG"},{"valor":"MS","significado":"Unidade federativa MS"},{"valor":"MT","significado":"Unidade federativa MT"},{"valor":"PA","significado":"Unidade federativa PA"},{"valor":"PB","significado":"Unidade federativa PB"},{"valor":"PE","significado":"Unidade federativa PE"},{"valor":"PI","significado":"Unidade federativa PI"},{"valor":"PR","significado":"Unidade federativa PR"},{"valor":"RJ","significado":"Unidade federativa RJ"},{"valor":"RN","significado":"Unidade federativa RN"},{"valor":"RO","significado":"Unidade federativa RO"},{"valor":"RR","significado":"Unidade federativa RR"},{"valor":"RS","significado":"Unidade federativa RS"},{"valor":"SC","significado":"Unidade federativa SC"},{"valor":"SE","significado":"Unidade federativa SE"},{"valor":"SP","significado":"Unidade federativa SP"},{"valor":"TO","significado":"Unidade federativa TO"},{"valor":"EX","significado":"Exterior"}],"condicao":"Para operação com o exterior o leiaute manda informar EX.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/UF (TUf)"},"isRequired":true,"uniqueKey":"destinatario.endereco.uf","typeLabel":"string"},"complemento":{"description":"Complemento do endereço (apto, sala, bloco)","type":"string","x-leiaute":{"tag":"xCpl","grupo":"enderDest: Endereço do Destinatário","tamanho":"1-60","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/xCpl","naoEmitido":"A engineAPI usa o complemento apenas no cadastro de clientes do emissor: a tag não é escrita no documento fiscal. Quando o complemento precisar aparecer na nota, inclua-o no logradouro."},"uniqueKey":"destinatario.endereco.complemento","typeLabel":"string"},"cep":{"description":"CEP do destinatário, só dígitos ou com hífen. Opcional no leiaute (8 dígitos, sem máscara)","type":"string","x-leiaute":{"tag":"CEP","grupo":"enderDest: Endereço do Destinatário","tamanho":"8","obrigatoriedadeLeiaute":"OC","condicao":"Opcional no leiaute. Quando informado, usa 8 dígitos sem máscara.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TEndereco/CEP"},"uniqueKey":"destinatario.endereco.cep","typeLabel":"string"}},"required":["logradouro","numero","bairro","codigoMunicipio","municipio","uf"],"additionalProperties":false,"x-leiaute":{"tag":"enderDest","grupo":"enderDest: Endereço do Destinatário","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório na NF-e, junto com o grupo do destinatário. O leiaute o marca como opcional na estrutura pelo mesmo motivo do grupo dest.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest/enderDest (TEndereco)","naoMapeado":"Grupo, não campo: enderDest é o contêiner do endereço."},"isRequired":true,"uniqueKey":"destinatario.endereco","typeLabel":"object"},"ie":{"description":"Inscrição Estadual do destinatário. Obrigatória (validada pela SEFAZ contra o CNPJ) quando indicadorIE = 1","type":"string","x-leiaute":{"tag":"IE","grupo":"dest: Identificação do Destinatário","tamanho":"2-14","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória nas operações com contribuinte do ICMS, ou seja, quando indicadorIE = 1. A SEFAZ valida a inscrição contra o CNPJ informado.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest/IE (TIeDestNaoIsento)"},"uniqueKey":"destinatario.ie","typeLabel":"string"},"indicadorIE":{"description":"Indicador de IE do destinatário: 1 = contribuinte (exige ie); 2 = isento; 9 = não contribuinte","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"indIEDest","grupo":"dest: Identificação do Destinatário","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"Contribuinte do ICMS (exige a inscrição estadual)"},{"valor":"2","significado":"Contribuinte isento de inscrição"},{"valor":"9","significado":"Não contribuinte"}],"condicao":"Ausente = 9 (não contribuinte).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest/indIEDest"},"uniqueKey":"destinatario.indicadorIE","typeLabel":"integer"},"email":{"description":"E-mail do destinatário (informativo, não usado para envio)","type":"string","x-leiaute":{"tag":"email","grupo":"dest: Identificação do Destinatário","tamanho":"1-60","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest/email","naoEmitido":"A engineAPI usa o e-mail apenas no cadastro de clientes do emissor: a tag não é escrita no documento fiscal, e a nota não é enviada por e-mail ao destinatário."},"uniqueKey":"destinatario.email","typeLabel":"string"}},"required":["cnpjCpf","nome","endereco"],"additionalProperties":false,"x-leiaute":{"tag":"dest","grupo":"dest: Identificação do Destinatário","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório na NF-e. O leiaute marca o grupo como opcional na estrutura porque o mesmo tipo descreve a NFC-e, em que a venda pode sair sem identificação do consumidor.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/dest","naoMapeado":"Grupo, não campo: dest é o contêiner dos dados de identificação do destinatário."},"isRequired":true,"uniqueKey":"destinatario","typeLabel":"object"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string","minLength":1,"description":"Código interno do produto (seu SKU)","x-leiaute":{"tag":"cProd","grupo":"I: Produtos e Serviços","tamanho":"1-60","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/cProd"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].codigo","typeLabel":"string"},"descricao":{"type":"string","minLength":1,"description":"Descrição do produto","x-leiaute":{"tag":"xProd","grupo":"I: Produtos e Serviços","tamanho":"1-120","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/xProd"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].descricao","typeLabel":"string"},"ncm":{"type":"string","pattern":"^(?:\\d{2}|\\d{8})$","description":"Nomenclatura Comum do Mercosul, com 2 ou 8 dígitos","x-leiaute":{"tag":"NCM","grupo":"I: Produtos e Serviços","tamanho":"2 ou 8","obrigatoriedadeLeiaute":"O","condicao":"O leiaute admite 2 ou 8 posições. Com 2 posições, informa-se o gênero do NCM fora de comércio exterior e de produto tributado pelo IPI.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/NCM"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ncm","typeLabel":"string"},"cfop":{"type":"string","minLength":1,"description":"Código Fiscal de Operações e Prestações (ex.: \"5102\" venda estadual, \"6102\" interestadual)","x-leiaute":{"tag":"CFOP","grupo":"I: Produtos e Serviços","tamanho":"4","obrigatoriedadeLeiaute":"O","condicao":"O leiaute restringe o primeiro dígito a 1, 2, 3, 5, 6 ou 7 (natureza da operação por origem/destino).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/CFOP"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].cfop","typeLabel":"string"},"unidade":{"type":"string","minLength":1,"description":"Unidade comercial: \"UN\", \"KG\", \"MT\", \"CX\", etc.","x-leiaute":{"tag":"uCom","grupo":"I: Produtos e Serviços","tamanho":"1-6","obrigatoriedadeLeiaute":"O","condicao":"Unidade COMERCIAL do item (como o produto é vendido). O leiaute tem duas unidades; a tributável tem campo próprio (`unidadeTributavel`) e, quando ele não vem, uTrib repete este valor.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/uCom"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].unidade","typeLabel":"string"},"quantidade":{"type":"number","minimum":0.0001,"description":"Quantidade vendida (mínimo 0.0001)","x-leiaute":{"tag":"qCom","grupo":"I: Produtos e Serviços","tamanho":"11v0-4","obrigatoriedadeLeiaute":"O","condicao":"Quantidade na unidade COMERCIAL. Sem quantidadeTributavel, qTrib repete este valor.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/qCom (TDec_1104v)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantidade","typeLabel":"number"},"valorUnitario":{"type":"number","minimum":0.01,"description":"Valor unitário do produto em R$ (mínimo 0.01)","x-leiaute":{"tag":"vUnCom","grupo":"I: Produtos e Serviços","tamanho":"11v0-10","obrigatoriedadeLeiaute":"O","condicao":"Valor unitário na unidade COMERCIAL. Sem valorUnitarioTributavel, vUnTrib repete este valor.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vUnCom (TDec_1110v)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].valorUnitario","typeLabel":"number"},"ean":{"description":"Código de barras EAN/GTIN do produto. Ausente = \"SEM GTIN\"","type":"string","x-leiaute":{"tag":"cEAN","grupo":"I: Produtos e Serviços","tamanho":"8, 12, 13 ou 14 (ou o literal SEM GTIN)","obrigatoriedadeLeiaute":"O","condicao":"A tag é sempre emitida: sem GTIN cadastrado, o leiaute manda escrever o literal \"SEM GTIN\", que é o que a engineAPI faz quando o campo vem ausente.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/cEAN"},"uniqueKey":"\\items.items.[INDEX].ean","typeLabel":"string"},"cest":{"description":"Código Especificador da Substituição Tributária, 7 dígitos sem pontuação (ex.: \"0100100\"). Transmitido no produto do documento; formato inválido devolve 422 CEST_INVALIDO","type":"string","x-leiaute":{"tag":"CEST","grupo":"I: Produtos e Serviços","tamanho":"7","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório para mercadoria sujeita a substituição tributária ou antecipação do recolhimento do imposto. A engineAPI tira a máscara antes de escrever (aceita \"01.001.00\").","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/CEST (dentro de xs:sequence minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].cest","typeLabel":"string"},"cBenef":{"type":"string","description":"Código do benefício fiscal (cBenef) concedido pela UF, exigido por algumas UFs quando o CST/CSOSN indica benefício (ex.: GO exige cBenef no CST 61 monofásico). Passthrough: o código vem da tabela de benefícios da própria UF, o motor não calcula nem confere","x-leiaute":{"tag":"cBenef","grupo":"I: Produtos e Serviços","tamanho":"8 ou 10 (ou o literal SEM CBENEF)","obrigatoriedadeLeiaute":"C","condicao":"Exigido por algumas UFs quando o CST/CSOSN indica benefício fiscal concedido pela própria UF (ex.: GO no CST 61 monofásico). O código vem da tabela de benefícios da UF: passthrough, o motor não confere.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/cBenef"},"uniqueKey":"\\items.items.[INDEX].cBenef","typeLabel":"string"},"valorTotal":{"description":"Redundante: sempre recalculado como quantidade × valorUnitario. Se enviado e divergente, 400","type":"number","x-leiaute":{"tag":"vProd","grupo":"I: Produtos e Serviços","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"O valor transmitido é SEMPRE quantidade × valorUnitario (a SEFAZ valida vProd = qCom × vUnCom). Informar valorTotal divergente devolve 400 antes de emitir; o campo é redundante no contrato.","preenchimento":"derivado","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vProd (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].valorTotal","typeLabel":"number"},"desconto":{"description":"Desconto INCONDICIONAL do item em R$ (vDesc do leiaute). Reduz a base do ICMS e do IBS/CBS. NÃO informe desconto condicional (sob condição/evento posterior): por lei ele integra a base e não tem campo no item","type":"number","minimum":0,"x-leiaute":{"tag":"vDesc","grupo":"I: Produtos e Serviços","tamanho":"13v2","obrigatoriedadeLeiaute":"OC","condicao":"Desconto INCONDICIONAL. Só é escrito quando maior que zero e reduz a base do ICMS e do IBS/CBS. Desconto condicional (sob evento posterior) integra a base por lei e não tem campo no item.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vDesc (TDec_1302Opc)"},"uniqueKey":"\\items.items.[INDEX].desconto","typeLabel":"number"},"valorFrete":{"description":"Frete do item em R$ (vFrete do leiaute), cobrado pelo próprio emitente e destacado no documento. Soma no vNF e integra a base do ICMS e do IBS/CBS","type":"number","minimum":0,"x-leiaute":{"tag":"vFrete","grupo":"I: Produtos e Serviços","tamanho":"13v2","obrigatoriedadeLeiaute":"OC","condicao":"Só é escrito quando maior que zero. Soma no total da nota e integra a base do ICMS e do IBS/CBS.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vFrete (TDec_1302Opc)"},"uniqueKey":"\\items.items.[INDEX].valorFrete","typeLabel":"number"},"valorSeguro":{"description":"Seguro do item em R$ (vSeg do leiaute). Soma no vNF e integra a base do ICMS e do IBS/CBS","type":"number","minimum":0,"x-leiaute":{"tag":"vSeg","grupo":"I: Produtos e Serviços","tamanho":"13v2","obrigatoriedadeLeiaute":"OC","condicao":"Só é escrito quando maior que zero. Soma no total da nota e integra a base do ICMS e do IBS/CBS.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vSeg (TDec_1302Opc)"},"uniqueKey":"\\items.items.[INDEX].valorSeguro","typeLabel":"number"},"outrasDespesas":{"description":"Outras despesas acessórias do item em R$ (vOutro do leiaute). Soma no vNF e integra a base do ICMS e do IBS/CBS","type":"number","minimum":0,"x-leiaute":{"tag":"vOutro","grupo":"I: Produtos e Serviços","tamanho":"13v2","obrigatoriedadeLeiaute":"OC","condicao":"Só é escrito quando maior que zero. Soma no total da nota e integra a base do ICMS e do IBS/CBS.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vOutro (TDec_1302Opc)"},"uniqueKey":"\\items.items.[INDEX].outrasDespesas","typeLabel":"number"},"indTot":{"oneOf":[{"type":"number","description":"Indica se o vProd do item compõe o vProd/vNF do total da nota (indTot do leiaute): 1 = compõe (ausente = 1, default do leiaute); 0 = não compõe. Não afeta a tributação do próprio item, só a composição do total","const":0,"x-leiaute":{"tag":"indTot","grupo":"I: Produtos e Serviços","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"O valor do item não compõe o total da nota"},{"valor":"1","significado":"O valor do item compõe o total da nota"}],"condicao":"Ausente = 1, o default do leiaute.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/indTot"},"uniqueKey":"\\items.items.[INDEX].indTot.oneOf.0","typeLabel":"number"},{"type":"number","description":"Indica se o vProd do item compõe o vProd/vNF do total da nota (indTot do leiaute): 1 = compõe (ausente = 1, default do leiaute); 0 = não compõe. Não afeta a tributação do próprio item, só a composição do total","const":1,"x-leiaute":{"tag":"indTot","grupo":"I: Produtos e Serviços","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"O valor do item não compõe o total da nota"},{"valor":"1","significado":"O valor do item compõe o total da nota"}],"condicao":"Ausente = 1, o default do leiaute.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/indTot"},"uniqueKey":"\\items.items.[INDEX].indTot.oneOf.1","typeLabel":"number"}],"uniqueKey":"\\items.items.[INDEX].indTot","typeLabel":"number"},"unidadeTributavel":{"description":"Unidade TRIBUTÁVEL do item (uTrib do leiaute), 1 a 6 caracteres, quando ela difere da unidade comercial: vende em \"CX\" e tributa em \"UN\". Ausente = igual a `unidade`. Vai junto com quantidadeTributavel e valorUnitarioTributavel","type":"string","minLength":1,"maxLength":6,"x-leiaute":{"tag":"uTrib","grupo":"I: Produtos e Serviços","tamanho":"1-6","obrigatoriedadeLeiaute":"O","condicao":"Unidade TRIBUTÁVEL do item, quando difere da comercial (vende em \"CX\", tributa em \"UN\"). Opcional no contrato: ausente, o documento repete a unidade comercial. Vai junto com quantidadeTributavel e valorUnitarioTributavel, e o par quantidade×valor tem que fechar com o mesmo vProd.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/uTrib"},"uniqueKey":"\\items.items.[INDEX].unidadeTributavel","typeLabel":"string"},"quantidadeTributavel":{"description":"Quantidade na unidade TRIBUTÁVEL (qTrib do leiaute, até 4 casas). Ausente = igual a `quantidade`. quantidadeTributavel × valorUnitarioTributavel tem que dar o mesmo vProd de quantidade × valorUnitario","type":"number","minimum":0.0001,"x-leiaute":{"tag":"qTrib","grupo":"I: Produtos e Serviços","tamanho":"11v0-4","obrigatoriedadeLeiaute":"O","condicao":"Quantidade na unidade TRIBUTÁVEL. Opcional no contrato: ausente, o documento repete a quantidade comercial.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/qTrib (TDec_1104v)"},"uniqueKey":"\\items.items.[INDEX].quantidadeTributavel","typeLabel":"number"},"valorUnitarioTributavel":{"description":"Valor unitário na unidade TRIBUTÁVEL em R$ (vUnTrib do leiaute, até 10 casas). Ausente = igual a `valorUnitario`. Caixa de 12 a R$ 100,00 tributada em unidades vira 8.3333333333","type":"number","exclusiveMinimum":0,"x-leiaute":{"tag":"vUnTrib","grupo":"I: Produtos e Serviços","tamanho":"11v0-10","obrigatoriedadeLeiaute":"O","condicao":"Valor unitário na unidade TRIBUTÁVEL. Opcional no contrato: ausente, o documento repete o valor unitário comercial. Aceita até 10 casas porque a conversão raramente é exata (caixa de 12 a R$ 100,00 → 8,3333333333).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/vUnTrib (TDec_1110v)"},"uniqueKey":"\\items.items.[INDEX].valorUnitarioTributavel","typeLabel":"number"},"icms":{"description":"Tributação de ICMS do item (obrigatório de fato só sem resolverTributacao)","type":"object","properties":{"origem":{"description":"Origem da mercadoria, conforme Torig do leiaute: 0=nacional; 1/2=estrangeira; 3/4/5/8=nacional conforme conteúdo de importação ou processo produtivo; 6/7=estrangeira sem similar nacional. Aceita 0 a 8. Ausente = 0","type":"integer","minimum":0,"maximum":8,"x-leiaute":{"tag":"orig","grupo":"N: ICMS Normal e ST","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Nacional, exceto os códigos 3, 4, 5 e 8"},{"valor":"1","significado":"Estrangeira, importação direta, exceto o código 6"},{"valor":"2","significado":"Estrangeira, adquirida no mercado interno, exceto o código 7"},{"valor":"3","significado":"Nacional, conteúdo de importação acima de 40% e até 70%"},{"valor":"4","significado":"Nacional, produção conforme processos produtivos básicos previstos em lei"},{"valor":"5","significado":"Nacional, conteúdo de importação igual ou inferior a 40%"},{"valor":"6","significado":"Estrangeira, importação direta, sem similar nacional, da lista CAMEX e gás natural"},{"valor":"7","significado":"Estrangeira, adquirida no mercado interno, sem similar nacional, da lista CAMEX e gás natural"},{"valor":"8","significado":"Nacional, conteúdo de importação superior a 70%"}],"condicao":"Ausente = 0 (nacional). A engineAPI deriva desta lista a validação do contrato e recusa valores fora de 0 a 8 antes da numeração. Os códigos 3 a 8 declaram percentual de conteúdo de importação, produto sem similar nacional da lista CAMEX e gás natural.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/*/orig (Torig)"},"uniqueKey":"\\items.items.[INDEX].icms.origem","typeLabel":"integer"},"cst":{"description":"Código de Situação Tributária do ICMS (Lucro Real/Presumido), ex.: \"00\" tributada integralmente, \"40\" isenta. \"10\" (tributada com ST), \"30\" (isenta ou não tributada com ST) e \"70\" (redução de base com ST) são a substituição tributária cobrada NESTA operação, o lado substituto (indústria, atacado, revenda que retém para a frente da cadeia): valem na NF-e para emissor em Regime Normal (CRT=3) ou Simples com excesso de sublimite (CRT=2), com modBCST/vBCST/pICMSST/vICMSST (e o ICMS próprio em modBC/vBC/pICMS/vICMS nos CST \"10\" e \"70\", mais pRedBC no \"70\"). \"60\" é o ICMS cobrado anteriormente por substituição tributária (revenda de mercadoria já retida pelo fornecedor: bebida, autopeça, cosmético, medicamento), nos mesmos regimes, com os campos vBCSTRet/pST/vICMSSTRet. \"02\" e \"61\" são a tributação monofásica de combustíveis e valem nos dois regimes, inclusive Simples Nacional (exigem o grupo combustivel e os campos qBCMono/adRemICMS/vICMSMono ou qBCMonoRet/adRemICMSRet/vICMSMonoRet)","type":"string","pattern":"^\\d{1,3}$","x-leiaute":{"tag":"CST","grupo":"N: ICMS Normal e ST","tamanho":"2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório no regime normal (Lucro Real/Presumido). No Simples Nacional o leiaute usa CSOSN no lugar; as duas tags nunca convivem no mesmo item. Valores do leiaute: 00, 02, 10, 15, 20, 30, 40, 41, 50, 51, 53, 60, 61, 70 e 90. Dos quatro CST monofásicos de combustível (02, 15, 53 e 61), a engineAPI emite hoje o 02 (própria) e o 61 (cobrada anteriormente); informar o 15 (com retenção) ou o 53 (com diferimento) é recusado, porque os campos próprios deles ainda não existem no contrato.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS{cst}/CST (o CST é o SUFIXO do nome do subgrupo)"},"uniqueKey":"\\items.items.[INDEX].icms.cst","typeLabel":"string"},"csosn":{"description":"Código de Situação da Operação do Simples Nacional, ex.: \"102\" tributada pelo Simples sem crédito, \"400\" não tributada. \"201\" (com permissão de crédito), \"202\" (sem permissão de crédito) e \"203\" (isenção na faixa de receita bruta) são a substituição tributária cobrada NESTA operação pelo emissor do Simples pleno (CRT=1), na NF-e (modelo 55): exigem modBCST/vBCST/pICMSST/vICMSST, e o \"201\" exige também pCredSN/vCredICMSSN (o crédito do art. 23 da LC 123/2006, que sai da sua apuração: o motor não o calcula)","type":"string","pattern":"^\\d{1,3}$","x-leiaute":{"tag":"CSOSN","grupo":"N: ICMS Normal e ST","tamanho":"3","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório no Simples Nacional (substitui o CST). Ausente = 102. Com resolverTributacao ligado, o Cérebro Fiscal resolve o CSOSN dos itens sem tributação manual.","valores":[{"valor":"101","significado":"Tributada pelo Simples Nacional com permissão de crédito"},{"valor":"102","significado":"Tributada pelo Simples Nacional sem permissão de crédito"},{"valor":"103","significado":"Isenção do ICMS no Simples Nacional para faixa de receita bruta"},{"valor":"201","significado":"Tributada com permissão de crédito e com cobrança do ICMS por substituição tributária"},{"valor":"202","significado":"Tributada sem permissão de crédito e com cobrança do ICMS por substituição tributária"},{"valor":"203","significado":"Isenção do ICMS para faixa de receita bruta e com cobrança do ICMS por substituição tributária"},{"valor":"300","significado":"Imune"},{"valor":"400","significado":"Não tributada pelo Simples Nacional"},{"valor":"500","significado":"ICMS cobrado anteriormente por substituição tributária ou por antecipação"},{"valor":"900","significado":"Outros"}],"preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMSSN{csosn}/CSOSN"},"uniqueKey":"\\items.items.[INDEX].icms.csosn","typeLabel":"string"},"aliquota":{"description":"Alíquota do ICMS em % (só com cst, regime CST)","type":"number","x-leiaute":{"tag":"pICMS","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com vBC nos CST que tributam.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS00/pICMS (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.aliquota","typeLabel":"number"},"baseCalculo":{"description":"Base de cálculo do ICMS em R$ (só com cst, regime CST)","type":"number","x-leiaute":{"tag":"vBC","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST que tributam (00, 10, 20, 51, 70, 90). No motor de regime normal a base é calculada do valor líquido do item; este campo é o passthrough para quem informa a tributação à mão.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS00/vBC (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.baseCalculo","typeLabel":"number"},"valor":{"description":"Valor do ICMS em R$ (só com cst, regime CST)","type":"number","x-leiaute":{"tag":"vICMS","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório junto com vBC e pICMS nos CST que tributam.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS00/vICMS (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.valor","typeLabel":"number"},"baseCalculoST":{"description":"Campo antigo, SEM EFEITO: informar devolve 422 ICMS_ST_NAO_SUPORTADO. A base da ST cobrada nesta operação hoje é vBCST, com o nome do leiaute (junto de modBCST, pICMSST e vICMSST, sob cst \"10\", \"30\" ou \"70\")","type":"number","x-leiaute":{"tag":"vBCST","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST com substituição tributária (10, 30, 70, 90) e no CSOSN 201/202/203.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/vBCST (TDec_1302)","naoEmitido":"A substituição tributária ainda não é suportada: informar ST devolve 422 ICMS_ST_NAO_SUPORTADO antes de consumir número fiscal, em vez de emitir documento sem a ST informada."},"uniqueKey":"\\items.items.[INDEX].icms.baseCalculoST","typeLabel":"number"},"aliquotaST":{"description":"Campo antigo, SEM EFEITO: informar devolve 422 ICMS_ST_NAO_SUPORTADO. A alíquota da ST cobrada nesta operação hoje é pICMSST (ver baseCalculoST)","type":"number","x-leiaute":{"tag":"pICMSST","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com vBCST nos CST com substituição tributária.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/pICMSST (TDec_0302a04)","naoEmitido":"A substituição tributária ainda não é suportada: informar ST devolve 422 ICMS_ST_NAO_SUPORTADO."},"uniqueKey":"\\items.items.[INDEX].icms.aliquotaST","typeLabel":"number"},"valorST":{"description":"Campo antigo, SEM EFEITO: informar devolve 422 ICMS_ST_NAO_SUPORTADO. O valor da ST cobrada nesta operação hoje é vICMSST (ver baseCalculoST)","type":"number","x-leiaute":{"tag":"vICMSST","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório junto com vBCST nos CST com substituição tributária.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/vICMSST (TDec_1302)","naoEmitido":"A substituição tributária ainda não é suportada: informar ST devolve 422 ICMS_ST_NAO_SUPORTADO."},"uniqueKey":"\\items.items.[INDEX].icms.valorST","typeLabel":"number"},"modBC":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): modalidade de determinação da base de cálculo do ICMS próprio. \"0\"=margem de valor agregado, \"1\"=pauta (valor), \"2\"=preço tabelado máximo (valor), \"3\"=valor da operação. Obrigatório nos CST 10, 20, 51, 70 e 90","type":"string","enum":["0","1","2","3"],"x-leiaute":{"tag":"modBC","grupo":"N: ICMS Normal e ST","tamanho":"1","obrigatoriedadeLeiaute":"C","valores":[{"valor":"0","significado":"Margem de valor agregado (%)"},{"valor":"1","significado":"Pauta (valor)"},{"valor":"2","significado":"Preço tabelado máximo (valor)"},{"valor":"3","significado":"Valor da operação"}],"condicao":"Obrigatório no CST 20 (redução de base), onde o leiaute exige o grupo completo. Opcional nos CST 51 e 90. No caminho assistido a engineAPI resolve a tributação e escreve a modalidade 3 (valor da operação).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/modBC"},"uniqueKey":"\\items.items.[INDEX].icms.modBC","typeLabel":"enum\u003cstring>"},"pRedBC":{"description":"CST 20/70 (obrigatório) e 51/90 (opcional): percentual de redução da base de cálculo do ICMS próprio, em %. No CST 70 é ele que distingue o 70 do 10, e no 20 o leiaute exige o grupo completo; inexistente nos CST 10 e 30. Em todos, informe a base JÁ REDUZIDA em vBC: o motor não aplica a redução por você","type":"number","minimum":0,"x-leiaute":{"tag":"pRedBC","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório no CST 20 (redução de base). A base transmitida em vBC JÁ É a base reduzida: a engineAPI não aplica a redução por você, e confere vICMS contra vBC vezes a alíquota, com tolerância de um centavo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/pRedBC (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.pRedBC","typeLabel":"number"},"vBC":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): base de cálculo do ICMS próprio em R$, como vai no documento. É passthrough: informe a base da SUA operação (nos CST 20 e 70 ela já entra reduzida pelo pRedBC). O motor confere vICMS = vBC x pICMS, com tolerância de R$ 0,01","type":"number","minimum":0,"x-leiaute":{"tag":"vBC","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Base de cálculo do ICMS próprio, como vai no documento. Obrigatória nos CST que têm ICMS próprio: 10 e 70 (substituição tributária cobrada nesta operação) e 20, 51 e 90 (benefício fiscal). Nos CST 20 e 70 ela já entra REDUZIDA pelo pRedBC: a engineAPI não recalcula. É o vocabulário canônico do contrato para esta tag; baseCalculo continua aceito no ICMS clássico e no Simples Nacional, mas junto de um desses CST é recusado (dois nomes para a mesma tag é ambiguidade).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/vBC (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBC","typeLabel":"number"},"pICMS":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): alíquota do ICMS próprio em %, ex.: 18 para 18%","type":"number","minimum":0,"x-leiaute":{"tag":"pICMS","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Alíquota do ICMS próprio. Obrigatória junto de vBC nos CST 10, 20, 51, 70 e 90. Vocabulário canônico do contrato para esta tag (aliquota segue aceito no ICMS clássico e no Simples Nacional).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/pICMS (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.pICMS","typeLabel":"number"},"vICMS":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): valor do ICMS próprio em R$. Precisa bater com vBC x pICMS (tolerância de R$ 0,01); divergente devolve 422 antes de emitir (ICMS_ST_INVALIDO nos CST de substituição, ICMS_BENEFICIO_INVALIDO nos de benefício)","type":"number","minimum":0,"x-leiaute":{"tag":"vICMS","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Valor do ICMS próprio. Obrigatório junto de vBC e pICMS nos CST 10, 20, 51, 70 e 90, e precisa bater com a base vezes a alíquota (tolerância de um centavo): a engineAPI recusa antes de numerar em vez de deixar a SEFAZ rejeitar depois. Soma no total de ICMS do documento. Vocabulário canônico do contrato para esta tag (valor segue aceito no ICMS clássico e no Simples Nacional).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/vICMS (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMS","typeLabel":"number"},"vBCFCP":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): base de cálculo do Fundo de Combate à Pobreza sobre o ICMS próprio, em R$. Bloco indivisível: vai com pFCP e vFCP","type":"number","minimum":0,"x-leiaute":{"tag":"vBCFCP","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Fundo de Combate à Pobreza, bloco indivisível: obrigatório junto com pFCP e vFCP. Disponível nos CST 20, 51 e 90.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/vBCFCP (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBCFCP","typeLabel":"number"},"pFCP":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): percentual do Fundo de Combate à Pobreza sobre o ICMS próprio, em %. Vai com vBCFCP e vFCP","type":"number","minimum":0,"x-leiaute":{"tag":"pFCP","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Fundo de Combate à Pobreza, bloco indivisível: obrigatório junto com vBCFCP e vFCP.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/pFCP (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pFCP","typeLabel":"number"},"vFCP":{"description":"CST 10/70 (substituição tributária) e 20/51/90 (benefício fiscal): valor do Fundo de Combate à Pobreza sobre o ICMS próprio, em R$. Vai com vBCFCP e pFCP, e soma no total do documento","type":"number","minimum":0,"x-leiaute":{"tag":"vFCP","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Fundo de Combate à Pobreza, bloco indivisível: obrigatório junto com vBCFCP e pFCP. Soma no total de FCP do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/vFCP (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vFCP","typeLabel":"number"},"modBCST":{"description":"CST 10/30/70 (Regime Normal) e CSOSN 201/202/203 (Simples Nacional): modalidade de determinação da base de cálculo da ST. \"0\"=preço tabelado ou máximo sugerido, \"1\"=lista negativa (valor), \"2\"=lista positiva (valor), \"3\"=lista neutra (valor), \"4\"=margem de valor agregado (%), \"5\"=pauta (valor), \"6\"=valor da operação. Obrigatório sempre que há ST cobrada nesta operação","type":"string","enum":["0","1","2","3","4","5","6"],"x-leiaute":{"tag":"modBCST","grupo":"N: ICMS Normal e ST","tamanho":"1","obrigatoriedadeLeiaute":"C","valores":[{"valor":"0","significado":"Preço tabelado ou máximo sugerido"},{"valor":"1","significado":"Lista negativa (valor)"},{"valor":"2","significado":"Lista positiva (valor)"},{"valor":"3","significado":"Lista neutra (valor)"},{"valor":"4","significado":"Margem de valor agregado (%)"},{"valor":"5","significado":"Pauta (valor)"},{"valor":"6","significado":"Valor da operação"}],"condicao":"Obrigatório nos três CST de substituição tributária cobrada nesta operação (10, 30 e 70) e nos CSOSN 201, 202 e 203 (a mesma substituição, declarada por emissor do Simples Nacional), junto de vBCST, pICMSST e vICMSST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/modBCST"},"uniqueKey":"\\items.items.[INDEX].icms.modBCST","typeLabel":"enum\u003cstring>"},"pMVAST":{"description":"CST 10/30/70 e CSOSN 201/202/203: percentual da margem de valor agregado da ST, em %. Opcional no leiaute (só faz sentido com modBCST \"4\"). Passa de 100% legitimamente em vários convênios: o motor não a usa para recalcular a base, apenas a transcreve","type":"number","minimum":0,"x-leiaute":{"tag":"pMVAST","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Opcional nos CST 10, 30 e 70 e nos CSOSN 201, 202 e 203: só faz sentido com modBCST 4 (margem de valor agregado). É transcrito como informado, nunca usado para recalcular a base: passa de 100% legitimamente em vários convênios.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/pMVAST (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pMVAST","typeLabel":"number"},"pRedBCST":{"description":"CST 10/30/70 e CSOSN 201/202/203: percentual de redução da base de cálculo da ST, em %. Opcional no leiaute. Informe a base JÁ REDUZIDA em vBCST: o motor não recalcula","type":"number","minimum":0,"x-leiaute":{"tag":"pRedBCST","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Opcional nos CST 10, 30 e 70 e nos CSOSN 201, 202 e 203. A base informada em vBCST já entra REDUZIDA: a engineAPI não recalcula.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/pRedBCST (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pRedBCST","typeLabel":"number"},"vBCST":{"description":"CST 10/30/70 e CSOSN 201/202/203: base de cálculo do ICMS-ST cobrado NESTA operação, em R$, como vai no documento. Passthrough: a base é sua, o motor não a estima a partir da margem. Soma no vBCST do total da nota","type":"number","minimum":0,"x-leiaute":{"tag":"vBCST","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST 10, 30 e 70 e nos CSOSN 201, 202 e 203. Passthrough: a engineAPI não estima a base da substituição a partir da margem de valor agregado (ela varia por estado, produto e convênio). Soma no total da base de substituição tributária do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/vBCST (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBCST","typeLabel":"number"},"pICMSST":{"description":"CST 10/30/70 e CSOSN 201/202/203: alíquota interna do ICMS-ST na UF de destino, em %. É informação sua: ela varia por UF, NCM e convênio, e o motor não a estima","type":"number","minimum":0,"x-leiaute":{"tag":"pICMSST","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST 10, 30 e 70 e nos CSOSN 201, 202 e 203: alíquota interna da substituição tributária no estado de destino, informada por você.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/pICMSST (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.pICMSST","typeLabel":"number"},"vICMSST":{"description":"CST 10/30/70 e CSOSN 201/202/203: valor do ICMS-ST cobrado nesta operação, em R$. Soma no vST do total da nota e COMPÕE o valor total do documento (vNF = produtos + vST + vFCPST + ...): os pagamentos precisam fechar com esse total. O motor não confere este valor contra vBCST x pICMSST (não há regra de validação escrita para essa conta, e conferir o que a fonte não afirma recusaria emissão legítima)","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSST","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST 10, 30 e 70 e nos CSOSN 201, 202 e 203. Soma no total de substituição tributária do documento e COMPÕE o valor total da nota, então os pagamentos precisam fechar com ele. A engineAPI não confere este valor contra a base vezes a alíquota: não há regra de validação escrita para essa conta.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/vICMSST (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSST","typeLabel":"number"},"vBCFCPST":{"description":"CST 10/30/70 e CSOSN 201/202/203: base de cálculo do Fundo de Combate à Pobreza retido por ST, em R$. Bloco indivisível: vai com pFCPST e vFCPST","type":"number","minimum":0,"x-leiaute":{"tag":"vBCFCPST","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do Fundo de Combate à Pobreza retido por substituição tributária (CST 10, 30 e 70 e CSOSN 201, 202 e 203), indivisível: obrigatório junto com pFCPST e vFCPST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/vBCFCPST (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBCFCPST","typeLabel":"number"},"pFCPST":{"description":"CST 10/30/70 e CSOSN 201/202/203: percentual do Fundo de Combate à Pobreza retido por ST, em %. Vai com vBCFCPST e vFCPST","type":"number","minimum":0,"x-leiaute":{"tag":"pFCPST","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Bloco do Fundo de Combate à Pobreza retido por substituição tributária (CST 10, 30 e 70 e CSOSN 201, 202 e 203), indivisível: obrigatório junto com vBCFCPST e vFCPST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/pFCPST (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pFCPST","typeLabel":"number"},"vFCPST":{"description":"CST 10/30/70 e CSOSN 201/202/203: valor do Fundo de Combate à Pobreza retido por ST, em R$. Vai com vBCFCPST e pFCPST, soma no vFCPST do total da nota e também COMPÕE o valor total do documento","type":"number","minimum":0,"x-leiaute":{"tag":"vFCPST","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do Fundo de Combate à Pobreza retido por substituição tributária (CST 10, 30 e 70 e CSOSN 201, 202 e 203), indivisível: obrigatório junto com vBCFCPST e pFCPST. Soma no total desse fundo no documento e COMPÕE o valor total da nota.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS10/vFCPST (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vFCPST","typeLabel":"number"},"pCredSN":{"description":"CSOSN 201: alíquota aplicável de cálculo do crédito do Simples Nacional, em % (art. 23 da LC 123/2006). Obrigatória nesse código, junto de vCredICMSSN. É informação sua: sai da sua apuração do Simples, e o motor não a calcula","type":"number","minimum":0,"x-leiaute":{"tag":"pCredSN","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório no CSOSN 201 (tributada COM permissão de crédito), junto de vCredICMSSN. É a alíquota aplicável de cálculo do crédito de que trata o artigo 23 da Lei Complementar 123/2006: sai da sua apuração do Simples Nacional, e a engineAPI não a calcula. No CSOSN 202 e 203 o leiaute não tem onde escrevê-la, e informá-la é recusado antes de numerar.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMSSN201/pCredSN (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.pCredSN","typeLabel":"number"},"vCredICMSSN":{"description":"CSOSN 201: valor do crédito de ICMS que o destinatário pode aproveitar nos termos do art. 23 da LC 123/2006, em R$. Obrigatório nesse código, junto de pCredSN. Não compõe o total do documento: é informação ao adquirente","type":"number","minimum":0,"x-leiaute":{"tag":"vCredICMSSN","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório no CSOSN 201, junto de pCredSN. É o valor do crédito de ICMS que o destinatário pode aproveitar nos termos do artigo 23 da Lei Complementar 123/2006. NÃO compõe o total da nota: é informação ao adquirente. Sem ele o documento sairia declarando crédito zero, então a emissão é recusada antes de numerar.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMSSN201/vCredICMSSN (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vCredICMSSN","typeLabel":"number"},"vBCSTRet":{"description":"CST 60: valor da base de cálculo do ICMS-ST retido anteriormente, em R$ (está na nota de entrada do fornecedor). Vai junto com pST e vICMSSTRet: o bloco é indivisível no leiaute","type":"number","minimum":0,"x-leiaute":{"tag":"vBCSTRet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do ST retido (CST 60), indivisível: obrigatório junto com pST e vICMSSTRet. O valor está na nota de entrada do fornecedor, que foi quem reteve o imposto.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vBCSTRet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBCSTRet","typeLabel":"number"},"pST":{"description":"CST 60: alíquota suportada pelo consumidor final, em % (campo pST do leiaute). Não é a alíquota que gerou a retenção: é informação de transparência ao destinatário, e por isso o motor NÃO confere vICMSSTRet contra vBCSTRet × pST","type":"number","minimum":0,"x-leiaute":{"tag":"pST","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Bloco do ST retido (CST 60), indivisível: obrigatório junto com vBCSTRet e vICMSSTRet. É a alíquota suportada pelo consumidor final, informação de transparência ao destinatário, e NÃO a que gerou a retenção: por isso o motor não confere vICMSSTRet contra vBCSTRet vezes pST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/pST (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pST","typeLabel":"number"},"vICMSSubstituto":{"description":"CST 60: valor do ICMS próprio do substituto, cobrado na operação anterior, em R$. Opcional no leiaute (algumas UFs exigem mesmo zerado); só é aceito acompanhando vBCSTRet/pST/vICMSSTRet","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSSubstituto","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Único campo opcional DENTRO do bloco do ST retido: só é aceito acompanhando vBCSTRet, pST e vICMSSTRet. É o ICMS próprio do substituto, cobrado na operação anterior; algumas UFs o exigem mesmo zerado.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vICMSSubstituto (TDec_1302, minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSSubstituto","typeLabel":"number"},"vICMSSTRet":{"description":"CST 60: valor do ICMS-ST retido anteriormente, em R$ (nota de entrada do fornecedor). Vai junto com vBCSTRet e pST","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSSTRet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do ST retido (CST 60), indivisível: obrigatório junto com vBCSTRet e pST. É o imposto que o fornecedor já reteve, conforme a nota de entrada.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vICMSSTRet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSSTRet","typeLabel":"number"},"vBCFCPSTRet":{"description":"CST 60: base de cálculo do FCP retido anteriormente por ST, em R$. Bloco indivisível: vai com pFCPSTRet e vFCPSTRet (e soma no vFCPSTRet do total da nota)","type":"number","minimum":0,"x-leiaute":{"tag":"vBCFCPSTRet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do FCP retido por ST (CST 60), indivisível: obrigatório junto com pFCPSTRet e vFCPSTRet.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vBCFCPSTRet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBCFCPSTRet","typeLabel":"number"},"pFCPSTRet":{"description":"CST 60: percentual do FCP retido anteriormente por ST, em %. Vai com vBCFCPSTRet e vFCPSTRet","type":"number","minimum":0,"x-leiaute":{"tag":"pFCPSTRet","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Bloco do FCP retido por ST (CST 60), indivisível: obrigatório junto com vBCFCPSTRet e vFCPSTRet.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/pFCPSTRet (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pFCPSTRet","typeLabel":"number"},"vFCPSTRet":{"description":"CST 60: valor do FCP retido anteriormente por ST, em R$. Vai com vBCFCPSTRet e pFCPSTRet","type":"number","minimum":0,"x-leiaute":{"tag":"vFCPSTRet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do FCP retido por ST (CST 60), indivisível: obrigatório junto com vBCFCPSTRet e pFCPSTRet. Soma no total de FCP retido do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vFCPSTRet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vFCPSTRet","typeLabel":"number"},"pRedBCEfet":{"description":"CST 60: percentual de redução da base de cálculo efetiva, em %. Bloco indivisível: vai com vBCEfet, pICMSEfet e vICMSEfet","type":"number","minimum":0,"x-leiaute":{"tag":"pRedBCEfet","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Bloco da base efetiva (CST 60), indivisível: obrigatório junto com vBCEfet, pICMSEfet e vICMSEfet.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/pRedBCEfet (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pRedBCEfet","typeLabel":"number"},"vBCEfet":{"description":"CST 60: valor da base de cálculo efetiva, em R$. Vai com pRedBCEfet, pICMSEfet e vICMSEfet","type":"number","minimum":0,"x-leiaute":{"tag":"vBCEfet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco da base efetiva (CST 60), indivisível: obrigatório junto com pRedBCEfet, pICMSEfet e vICMSEfet.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vBCEfet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vBCEfet","typeLabel":"number"},"pICMSEfet":{"description":"CST 60: alíquota do ICMS efetivo, em %. Vai com pRedBCEfet, vBCEfet e vICMSEfet","type":"number","minimum":0,"x-leiaute":{"tag":"pICMSEfet","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Bloco da base efetiva (CST 60), indivisível: obrigatório junto com pRedBCEfet, vBCEfet e vICMSEfet.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/pICMSEfet (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pICMSEfet","typeLabel":"number"},"vICMSEfet":{"description":"CST 60: valor do ICMS efetivo, em R$. Vai com pRedBCEfet, vBCEfet e pICMSEfet","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSEfet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco da base efetiva (CST 60), indivisível: obrigatório junto com pRedBCEfet, vBCEfet e pICMSEfet.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS60/vICMSEfet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSEfet","typeLabel":"number"},"qBCMono":{"description":"CST 02: quantidade tributada do ICMS monofásico próprio, na unidade de medida do produto (não em R$). Obrigatória com cst \"02\" (a SEFAZ rejeita com 767)","type":"number","x-leiaute":{"tag":"qBCMono","grupo":"N: ICMS Normal e ST","tamanho":"11v0-4","obrigatoriedadeLeiaute":"C","condicao":"Tributação monofásica PRÓPRIA (CST 02). É uma QUANTIDADE na unidade do produto, não um valor em reais.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS02/qBCMono (TDec_1104v)"},"uniqueKey":"\\items.items.[INDEX].icms.qBCMono","typeLabel":"number"},"adRemICMS":{"description":"CST 02: alíquota AD REM do ICMS monofásico, em R$ por unidade (não é percentual). Definida na legislação para o produto ANP","type":"number","x-leiaute":{"tag":"adRemICMS","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Tributação monofásica própria (CST 02): alíquota AD REM, em reais por unidade, definida em lei para o produto ANP. Não é percentual.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS02/adRemICMS (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.adRemICMS","typeLabel":"number"},"vICMSMono":{"description":"CST 02: valor do ICMS monofásico próprio em R$. Precisa bater com qBCMono × adRemICMS (tolerância de R$ 0,01); divergente devolve 422 ICMS_MONOFASICO_INVALIDO antes de emitir","type":"number","x-leiaute":{"tag":"vICMSMono","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Tributação monofásica própria (CST 02). Precisa bater com qBCMono × adRemICMS (tolerância de R$ 0,01); divergente devolve 422 ICMS_MONOFASICO_INVALIDO.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS02/vICMSMono (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSMono","typeLabel":"number"},"qBCMonoRet":{"description":"CST 61: quantidade tributada do ICMS monofásico retido anteriormente, na unidade do produto (não em R$). Obrigatória com cst \"61\" (a SEFAZ rejeita com 769)","type":"number","x-leiaute":{"tag":"qBCMonoRet","grupo":"N: ICMS Normal e ST","tamanho":"11v0-4","obrigatoriedadeLeiaute":"C","condicao":"Tributação monofásica COBRADA ANTERIORMENTE, a revenda (CST 61). É uma QUANTIDADE na unidade do produto, não um valor em reais.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS61/qBCMonoRet (TDec_1104v)"},"uniqueKey":"\\items.items.[INDEX].icms.qBCMonoRet","typeLabel":"number"},"adRemICMSRet":{"description":"CST 61: alíquota AD REM do ICMS retido anteriormente, em R$ por unidade (não é percentual)","type":"number","x-leiaute":{"tag":"adRemICMSRet","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Revenda monofásica (CST 61): alíquota AD REM do imposto retido anteriormente, em reais por unidade. Não é percentual.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS61/adRemICMSRet (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].icms.adRemICMSRet","typeLabel":"number"},"vICMSMonoRet":{"description":"CST 61: valor do ICMS monofásico retido anteriormente em R$. Precisa bater com qBCMonoRet × adRemICMSRet (tolerância de R$ 0,01)","type":"number","x-leiaute":{"tag":"vICMSMonoRet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Revenda monofásica (CST 61). Precisa bater com qBCMonoRet × adRemICMSRet (tolerância de R$ 0,01); divergente devolve 422 ICMS_MONOFASICO_INVALIDO.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS61/vICMSMonoRet (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSMonoRet","typeLabel":"number"},"ufDestino":{"description":"Partilha do ICMS interestadual devida à UF de destino (grupo ICMSUFDest do leiaute, o DIFAL da EC 87/2015). Só vale quando a operação é interestadual (idDest 2), a consumidor final (indFinal 1) e o destinatário não é contribuinte (indicadorIE 9 ou ausente); fora disso a emissão devolve 422 DIFAL_NAO_APLICAVEL. Passthrough: o motor valida e transcreve, não calcula a partilha","type":"object","properties":{"vBCUFDest":{"type":"number","minimum":0,"description":"Base de cálculo do ICMS na UF do destinatário, em R$. É apurada pela legislação da UF de DESTINO (a LC 87/1996, art. 13 § 7º, manda usar a alíquota interna de lá para estabelecer a base; o § 3º cuida do valor devido), e pode diferir da base da operação própria: por isso o motor não a deriva, você a informa","x-leiaute":{"tag":"vBCUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha, que só existe na venda interestadual a consumidor final não contribuinte. A base é apurada pela legislação da UF de DESTINO e pode não coincidir com a base da operação própria: por isso ela é informada, nunca derivada.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/vBCUFDest (TDec_1302)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.vBCUFDest","typeLabel":"number"},"pICMSUFDest":{"type":"number","minimum":0,"description":"Alíquota interna da UF do destinatário para o produto, em %. É a alíquota de LÁ: a curadoria da engineAPI cobre a alíquota interna da UF de origem, então este número é seu","x-leiaute":{"tag":"pICMSUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha. É a alíquota interna da UF de DESTINO para o produto: a curadoria da engineAPI cobre a alíquota interna da UF de origem, então este número vem do integrador.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/pICMSUFDest (TDec_0302a04)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pICMSUFDest","typeLabel":"number"},"pICMSInter":{"oneOf":[{"type":"number","description":"Alíquota interestadual da operação, em %. Domínio fechado no leiaute: 4 (mercadoria importada), 7 (origem no Sul/Sudeste exceto ES com destino ao Norte/Nordeste/Centro-Oeste ou ES) ou 12 (demais casos)","const":4,"x-leiaute":{"tag":"pICMSInter","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"5 (4.00, 7.00 ou 12.00)","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha. Domínio fechado no leiaute: valor fora dele é recusado antes da emissão.","valores":[{"valor":"4","significado":"Mercadoria importada"},{"valor":"7","significado":"Origem no Sul ou Sudeste (exceto ES) com destino ao Norte, Nordeste, Centro-Oeste ou ES"},{"valor":"12","significado":"Demais casos"}],"preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/pICMSInter"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pICMSInter.oneOf.0","typeLabel":"number"},{"type":"number","description":"Alíquota interestadual da operação, em %. Domínio fechado no leiaute: 4 (mercadoria importada), 7 (origem no Sul/Sudeste exceto ES com destino ao Norte/Nordeste/Centro-Oeste ou ES) ou 12 (demais casos)","const":7,"x-leiaute":{"tag":"pICMSInter","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"5 (4.00, 7.00 ou 12.00)","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha. Domínio fechado no leiaute: valor fora dele é recusado antes da emissão.","valores":[{"valor":"4","significado":"Mercadoria importada"},{"valor":"7","significado":"Origem no Sul ou Sudeste (exceto ES) com destino ao Norte, Nordeste, Centro-Oeste ou ES"},{"valor":"12","significado":"Demais casos"}],"preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/pICMSInter"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pICMSInter.oneOf.1","typeLabel":"number"},{"type":"number","description":"Alíquota interestadual da operação, em %. Domínio fechado no leiaute: 4 (mercadoria importada), 7 (origem no Sul/Sudeste exceto ES com destino ao Norte/Nordeste/Centro-Oeste ou ES) ou 12 (demais casos)","const":12,"x-leiaute":{"tag":"pICMSInter","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"5 (4.00, 7.00 ou 12.00)","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha. Domínio fechado no leiaute: valor fora dele é recusado antes da emissão.","valores":[{"valor":"4","significado":"Mercadoria importada"},{"valor":"7","significado":"Origem no Sul ou Sudeste (exceto ES) com destino ao Norte, Nordeste, Centro-Oeste ou ES"},{"valor":"12","significado":"Demais casos"}],"preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/pICMSInter"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pICMSInter.oneOf.2","typeLabel":"number"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pICMSInter","typeLabel":"number"},"pICMSInterPart":{"type":"number","minimum":0,"description":"Percentual de partilha destinado à UF do destinatário, em %. Desde 2019 é 100 (EC 87/2015, art. 99 do ADCT); valor diferente devolve 422 DIFAL_INVALIDO antes de emitir","x-leiaute":{"tag":"pICMSInterPart","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha, e é ele que faz o grupo existir no documento: zerado, o motor fiscal não emite o grupo nenhum. O leiaute publica a tabela de vigência (40% em 2016, 60% em 2017, 80% em 2018, 100% a partir de 2019), então hoje o valor é 100.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/pICMSInterPart (TDec_0302a04)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pICMSInterPart","typeLabel":"number"},"vICMSUFDest":{"type":"number","minimum":0,"description":"Valor do ICMS de partilha devido à UF do destinatário, em R$. Passthrough: o motor não calcula a partilha, porque a base e a alíquota interna são da UF de destino","x-leiaute":{"tag":"vICMSUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha, e soma no total do documento. Transcrito como informado: a conta depende da legislação da UF de destino, e o motor não a refaz.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/vICMSUFDest (TDec_1302)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.vICMSUFDest","typeLabel":"number"},"vICMSUFRemet":{"type":"number","minimum":0,"description":"Valor do ICMS de partilha devido à UF do remetente, em R$. Desde 2019 é 0.00 (a partilha é integral para o destino), e o campo continua obrigatório no leiaute","x-leiaute":{"tag":"vICMSUFRemet","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo da partilha, e soma no total do documento. O próprio leiaute anota no campo que, a partir de 2019, este valor é zero (a partilha passou a ser integral para o destino).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/vICMSUFRemet (TDec_1302)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.vICMSUFRemet","typeLabel":"number"},"vBCFCPUFDest":{"description":"Base de cálculo do FCP na UF do destinatário, em R$. Bloco indivisível: vai com pFCPUFDest e vFCPUFDest","type":"number","minimum":0,"x-leiaute":{"tag":"vBCFCPUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do adicional de FCP da UF de destino: informe base, percentual e valor juntos, ou nenhum dos três. Só existe quando a UF de destino cobra o adicional para o produto.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/vBCFCPUFDest (TDec_1302, minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.vBCFCPUFDest","typeLabel":"number"},"pFCPUFDest":{"description":"Percentual do Fundo de Combate à Pobreza (FCP) da UF de destino, em % (adicional à alíquota interna de lá, não incluído em pICMSUFDest). Vai com vBCFCPUFDest e vFCPUFDest","type":"number","minimum":0,"x-leiaute":{"tag":"pFCPUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Bloco do adicional de FCP da UF de destino, indivisível: vai com vBCFCPUFDest e vFCPUFDest. É percentual ADICIONAL à alíquota interna do destino, não incluído em pICMSUFDest.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/pFCPUFDest (TDec_0302a04, minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.pFCPUFDest","typeLabel":"number"},"vFCPUFDest":{"description":"Valor do FCP devido à UF de destino, em R$. Precisa bater com vBCFCPUFDest × pFCPUFDest (tolerância de R$ 0,01); soma no total da nota","type":"number","minimum":0,"x-leiaute":{"tag":"vFCPUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Bloco do adicional de FCP da UF de destino, indivisível: vai com vBCFCPUFDest e pFCPUFDest, precisa bater com a multiplicação dos dois (tolerância de 1 centavo) e soma no total do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest/vFCPUFDest (TDec_1302, minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].icms.ufDestino.vFCPUFDest","typeLabel":"number"}},"required":["vBCUFDest","pICMSUFDest","pICMSInter","pICMSInterPart","vICMSUFDest","vICMSUFRemet"],"additionalProperties":false,"x-leiaute":{"tag":"ICMSUFDest","grupo":"NA: ICMS para a UF de destino (partilha interestadual)","obrigatoriedadeLeiaute":"C","condicao":"Grupo opcional na estrutura do leiaute e devido pela norma quando a operação é interestadual, a consumidor final e o destinatário não é contribuinte do ICMS. Informado fora dessa hipótese, a emissão é recusada antes de numerar.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMSUFDest (minOccurs=\"0\")","naoMapeado":"Grupo, não campo: `ICMSUFDest` é o contêiner da partilha e não carrega valor próprio. As tags estão nos campos de dentro."},"uniqueKey":"\\items.items.[INDEX].icms.ufDestino","typeLabel":"object"},"cBenefRBC":{"description":"CST 51: código do benefício fiscal da UF aplicado ao item quando há redução de base no diferimento, 8 ou 10 caracteres alfanuméricos. Só existe no grupo do CST 51 no leiaute; em outro CST a emissão recusa com 422 ICMS_BENEFICIO_INVALIDO. Passthrough: conferimos o formato, não a existência do código na tabela da UF","type":"string","x-leiaute":{"tag":"cBenefRBC","grupo":"N: ICMS Normal e ST","tamanho":"8 ou 10","obrigatoriedadeLeiaute":"C","condicao":"Código do benefício fiscal na UF aplicado ao item quando o diferimento (CST 51) vem com redução de base. Só existe nesse grupo: em outro CST a emissão recusa antes de consumir número fiscal. A engineAPI confere o FORMATO (8 ou 10 caracteres); conferir se o código existe na tabela da sua UF é responsabilidade do emitente.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/cBenefRBC"},"uniqueKey":"\\items.items.[INDEX].icms.cBenefRBC","typeLabel":"string"},"vICMSDeson":{"description":"CST 20/40/41/50/90: valor do ICMS desonerado, em R$. Bloco indivisível: vai SEMPRE com motDesICMS e indDeduzDeson. Soma no vICMSDeson do total da nota","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSDeson","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Desoneração do ICMS, bloco indivisível: obrigatório junto com motDesICMS e indDeduzDeson. Disponível nos CST 20, 40, 41, 50 e 90. Soma no total de ICMS desonerado do documento, que a SEFAZ confere contra a soma dos itens.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/vICMSDeson (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSDeson","typeLabel":"number"},"motDesICMS":{"description":"CST 20/40/41/50/90: motivo da desoneração do ICMS. Os códigos válidos DIFEREM por CST (no 20 e no 90 o leiaute só admite 3, 9 e 12; no 40, 41 e 50 admite 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 16 e 90): motivo fora do conjunto do CST devolve 422 ICMS_BENEFICIO_INVALIDO","type":"string","x-leiaute":{"tag":"motDesICMS","grupo":"N: ICMS Normal e ST","tamanho":"1-2","obrigatoriedadeLeiaute":"C","valores":[{"valor":"1","significado":"Táxi (apenas nos CST 40, 41 e 50)"},{"valor":"3","significado":"Produtor agropecuário / uso na agropecuária"},{"valor":"4","significado":"Frotista ou locadora (apenas nos CST 40, 41 e 50)"},{"valor":"5","significado":"Diplomático ou consular (apenas nos CST 40, 41 e 50)"},{"valor":"6","significado":"Utilitários e motocicletas da Amazônia Ocidental e Áreas de Livre Comércio (apenas nos CST 40, 41 e 50)"},{"valor":"7","significado":"SUFRAMA (apenas nos CST 40, 41 e 50)"},{"valor":"8","significado":"Venda a órgão público (apenas nos CST 40, 41 e 50)"},{"valor":"9","significado":"Outros"},{"valor":"10","significado":"Deficiente condutor (apenas nos CST 40, 41 e 50)"},{"valor":"11","significado":"Deficiente não condutor (apenas nos CST 40, 41 e 50)"},{"valor":"12","significado":"Fomento agropecuário (apenas nos CST 20 e 90)"},{"valor":"16","significado":"Olimpíadas Rio 2016 (apenas nos CST 40, 41 e 50)"},{"valor":"90","significado":"Solicitado pelo fisco (apenas nos CST 40, 41 e 50)"}],"condicao":"Obrigatório sempre que vICMSDeson é informado. Os códigos válidos DIFEREM por CST: nos CST 20 e 90 o leiaute admite apenas 3, 9 e 12; nos CST 40, 41 e 50 admite 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 16 e 90. Motivo fora do conjunto do CST devolve 422 antes de consumir número fiscal.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/motDesICMS"},"uniqueKey":"\\items.items.[INDEX].icms.motDesICMS","typeLabel":"string"},"indDeduzDeson":{"description":"CST 20/40/41/50/90: o valor desonerado deduz do total da nota? \"1\"=deduz (o vNF sai reduzido), \"0\"=não deduz. Obrigatório sempre que vICMSDeson é informado: o leiaute não define o que significa a ausência do indicador, e o total da nota depende dele","type":"string","enum":["0","1"],"x-leiaute":{"tag":"indDeduzDeson","grupo":"N: ICMS Normal e ST","tamanho":"1","obrigatoriedadeLeiaute":"C","valores":[{"valor":"0","significado":"O valor desonerado NÃO deduz do total da nota"},{"valor":"1","significado":"O valor desonerado deduz do total da nota"}],"condicao":"Opcional no leiaute e OBRIGATÓRIO na engineAPI sempre que vICMSDeson é informado: o total da nota depende dele, e o leiaute define o significado de 0 e de 1 sem definir o da ausência. Exigir o indicador é mais estrito que a norma, de propósito: total de nota errado em silêncio é a pior classe de defeito de um motor fiscal.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS20/indDeduzDeson (minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].icms.indDeduzDeson","typeLabel":"enum\u003cstring>"},"vICMSOp":{"description":"CST 51: valor do ICMS da operação (o imposto que seria devido sem o diferimento), em R$","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSOp","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Diferimento (CST 51): valor do ICMS da operação, o imposto que seria devido sem o benefício. Informado junto com vICMSDif e vICMS, a engineAPI confere a identidade vICMSOp = vICMSDif + vICMS, com tolerância de um centavo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/vICMSOp (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSOp","typeLabel":"number"},"pDif":{"description":"CST 51: percentual do diferimento, em %","type":"number","minimum":0,"x-leiaute":{"tag":"pDif","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (máximo 100)","obrigatoriedadeLeiaute":"C","condicao":"Diferimento (CST 51): percentual do diferimento. A engineAPI NÃO confere o valor diferido contra este percentual: a proporção fica a critério de cada UF, e conferir uma fórmula que a norma não afirma fecharia emissão legítima.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/pDif (TDec_0302a04Max100)"},"uniqueKey":"\\items.items.[INDEX].icms.pDif","typeLabel":"number"},"vICMSDif":{"description":"CST 51: valor do ICMS diferido, em R$. Informado junto com vICMSOp e valor (o ICMS devido), precisa fechar a identidade vICMSOp = vICMSDif + valor (tolerância de R$ 0,01)","type":"number","minimum":0,"x-leiaute":{"tag":"vICMSDif","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Diferimento (CST 51): valor do ICMS diferido, a parcela cujo recolhimento fica adiado. Ver a identidade conferida em vICMSOp.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/vICMSDif (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vICMSDif","typeLabel":"number"},"pFCPDif":{"description":"CST 51: percentual do FCP diferido, em %. Bloco indivisível: vai com vFCPDif","type":"number","minimum":0,"x-leiaute":{"tag":"pFCPDif","grupo":"N: ICMS Normal e ST","tamanho":"3v2-4 (o tipo do leiaute não aceita zero)","obrigatoriedadeLeiaute":"C","condicao":"Fundo de Combate à Pobreza diferido (CST 51), bloco indivisível: obrigatório junto com vFCPDif.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/pFCPDif (TDec_0302a04Opc)"},"uniqueKey":"\\items.items.[INDEX].icms.pFCPDif","typeLabel":"number"},"vFCPDif":{"description":"CST 51: valor do FCP diferido, em R$. Vai com pFCPDif; vFCPEfet é opcional dentro do mesmo bloco","type":"number","minimum":0,"x-leiaute":{"tag":"vFCPDif","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Fundo de Combate à Pobreza diferido (CST 51), bloco indivisível: obrigatório junto com pFCPDif.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/vFCPDif (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].icms.vFCPDif","typeLabel":"number"},"vFCPEfet":{"description":"CST 51: valor efetivo do FCP, em R$. Único campo opcional dentro do bloco do FCP diferido: só é aceito acompanhando pFCPDif e vFCPDif","type":"number","minimum":0,"x-leiaute":{"tag":"vFCPEfet","grupo":"N: ICMS Normal e ST","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Único campo opcional DENTRO do bloco do Fundo de Combate à Pobreza diferido (CST 51): só é aceito acompanhando pFCPDif e vFCPDif. Sozinho, não chegaria ao documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS/ICMS51/vFCPEfet (TDec_1302, minOccurs=\"0\")"},"uniqueKey":"\\items.items.[INDEX].icms.vFCPEfet","typeLabel":"number"}},"additionalProperties":false,"x-leiaute":{"tag":"ICMS","grupo":"N: ICMS Normal e ST","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/ICMS (choice entre ICMS00..ICMS90 e ICMSSN101..ICMSSN900)","naoMapeado":"Grupo, não campo: o leiaute escolhe o subgrupo (ICMS00, ICMS61, ICMSSN102...) pelo CST/CSOSN informado, e é o subgrupo que carrega as tags."},"uniqueKey":"\\items.items.[INDEX].icms","typeLabel":"object"},"pis":{"description":"Tributação de PIS do item (passthrough: vai como informado para o documento)","type":"object","properties":{"cst":{"description":"Código de Situação Tributária do PIS. Tributado por alíquota: \"01\"/\"02\" (exige baseCalculo, aliquota e valor). Por quantidade: \"03\" (exige quantidadeVendida, valorAliquotaUnidade e valor). Não tributado: \"04\"-\"09\" (só o CST vai no documento). Outras operações: \"49\"-\"56\", \"60\"-\"67\", \"70\"-\"75\", \"98\" e \"99\". Ausente = \"99\" com valores zerados","type":"string","pattern":"^\\d{1,3}$","x-leiaute":{"tag":"CST","grupo":"PIS: Programa de Integração Social","tamanho":"2","obrigatoriedadeLeiaute":"O","condicao":"Tributado por alíquota: 01 e 02 (exigem base, alíquota e valor). Tributado por quantidade: 03 (exige quantidade vendida, alíquota por unidade e valor; vira qBCProd/vAliqProd; base e alíquota percentual não existem nesse subgrupo). Não tributado: 04 a 09 (só o CST vai no documento). Outras operações: 49 a 56, 60 a 67, 70 a 75, 98 e 99. Ausente = 99 com valores zerados.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS/PISAliq/CST e demais subgrupos"},"uniqueKey":"\\items.items.[INDEX].pis.cst","typeLabel":"string"},"baseCalculo":{"description":"Base de cálculo do PIS em R$ (transmitida como vBC). Só existe no grupo por ALÍQUOTA (cst \"01\"/\"02\"/\"49\"-\"99\")","type":"number","x-leiaute":{"tag":"vBC","grupo":"PIS: Programa de Integração Social","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória nos CST que carregam valores por ALÍQUOTA (01, 02 e a faixa de outras operações). Nos CST não tributados o subgrupo do leiaute só tem o CST; no CST 03 (por quantidade) o subgrupo não tem esta tag: usa quantidadeVendida/valorAliquotaUnidade.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS/PISAliq/vBC (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].pis.baseCalculo","typeLabel":"number"},"aliquota":{"description":"Alíquota do PIS em % (transmitida como pPIS). Só existe no grupo por ALÍQUOTA (cst \"01\"/\"02\"/\"49\"-\"99\")","type":"number","x-leiaute":{"tag":"pPIS","grupo":"PIS: Programa de Integração Social","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com a base nos CST que carregam valores por ALÍQUOTA. No CST 03 (por quantidade) o subgrupo não tem esta tag.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS/PISAliq/pPIS (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].pis.aliquota","typeLabel":"number"},"quantidadeVendida":{"description":"CST \"03\" (PIS por quantidade): quantidade vendida na unidade de tributação do PIS (transmitida como qBCProd). O motor é passthrough: NÃO deriva este valor de \"items[].quantidade\" (a quantidade comercial), que pode divergir da tributável","type":"number","x-leiaute":{"tag":"qBCProd","grupo":"PIS: Programa de Integração Social","tamanho":"12v0-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com valorAliquotaUnidade e valor no CST 03 (tributado por quantidade). Não existe nos demais CST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS/PISQtde/qBCProd (TDec_1204v)"},"uniqueKey":"\\items.items.[INDEX].pis.quantidadeVendida","typeLabel":"number"},"valorAliquotaUnidade":{"description":"CST \"03\" (PIS por quantidade): alíquota do PIS em R$ por unidade de produto (transmitida como vAliqProd)","type":"number","x-leiaute":{"tag":"vAliqProd","grupo":"PIS: Programa de Integração Social","tamanho":"11v0-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com quantidadeVendida e valor no CST 03 (tributado por quantidade). Não existe nos demais CST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS/PISQtde/vAliqProd (TDec_1104v)"},"uniqueKey":"\\items.items.[INDEX].pis.valorAliquotaUnidade","typeLabel":"number"},"valor":{"description":"Valor do PIS em R$ (transmitido como vPIS e somado no total da nota). Comum aos dois grupos (alíquota e quantidade)","type":"number","x-leiaute":{"tag":"vPIS","grupo":"PIS: Programa de Integração Social","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST que carregam valores, seja por ALÍQUOTA (base + alíquota) seja por QUANTIDADE (quantidadeVendida + valorAliquotaUnidade, CST 03). Soma no total da nota (tag de mesmo nome no grupo de totais), mas não compõe o valor a pagar.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS/PISAliq/vPIS (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].pis.valor","typeLabel":"number"}},"additionalProperties":false,"x-leiaute":{"tag":"PIS","grupo":"PIS: Programa de Integração Social","obrigatoriedadeLeiaute":"C","condicao":"O leiaute marca o grupo como opcional na estrutura. A engineAPI o emite SEMPRE: item que não informa o tributo sai com CST 99 e valores zerados, em vez de sair sem o grupo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/PIS (choice entre PISAliq, PISQtde, PISNT e PISOutr)","naoMapeado":"Grupo, não campo: o leiaute escolhe o subgrupo pelo CST informado, e é o subgrupo que carrega as tags."},"uniqueKey":"\\items.items.[INDEX].pis","typeLabel":"object"},"cofins":{"description":"Tributação de COFINS do item (passthrough: vai como informado para o documento)","type":"object","properties":{"cst":{"description":"Código de Situação Tributária da COFINS. Mesmas faixas do PIS: \"01\"/\"02\" por alíquota (exige baseCalculo, aliquota e valor), \"03\" por quantidade (exige quantidadeVendida, valorAliquotaUnidade e valor), \"04\"-\"09\" não tributado, outras operações: \"49\"-\"56\", \"60\"-\"67\", \"70\"-\"75\", \"98\" e \"99\". Ausente = \"99\" com valores zerados","type":"string","pattern":"^\\d{1,3}$","x-leiaute":{"tag":"CST","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","tamanho":"2","obrigatoriedadeLeiaute":"O","condicao":"Tributado por alíquota: 01 e 02 (exigem base, alíquota e valor). Tributado por quantidade: 03 (exige quantidade vendida, alíquota por unidade e valor; vira qBCProd/vAliqProd; base e alíquota percentual não existem nesse subgrupo). Não tributado: 04 a 09 (só o CST vai no documento). Outras operações: 49 a 56, 60 a 67, 70 a 75, 98 e 99. Ausente = 99 com valores zerados.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS/COFINSAliq/CST e demais subgrupos"},"uniqueKey":"\\items.items.[INDEX].cofins.cst","typeLabel":"string"},"baseCalculo":{"description":"Base de cálculo da COFINS em R$ (transmitida como vBC). Só existe no grupo por ALÍQUOTA (cst \"01\"/\"02\"/\"49\"-\"99\")","type":"number","x-leiaute":{"tag":"vBC","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória nos CST que carregam valores por ALÍQUOTA (01, 02 e a faixa de outras operações). Nos CST não tributados o subgrupo do leiaute só tem o CST; no CST 03 (por quantidade) o subgrupo não tem esta tag: usa quantidadeVendida/valorAliquotaUnidade.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS/COFINSAliq/vBC (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].cofins.baseCalculo","typeLabel":"number"},"aliquota":{"description":"Alíquota da COFINS em % (transmitida como pCOFINS). Só existe no grupo por ALÍQUOTA (cst \"01\"/\"02\"/\"49\"-\"99\")","type":"number","x-leiaute":{"tag":"pCOFINS","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com a base nos CST que carregam valores por ALÍQUOTA. No CST 03 (por quantidade) o subgrupo não tem esta tag.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS/COFINSAliq/pCOFINS (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].cofins.aliquota","typeLabel":"number"},"quantidadeVendida":{"description":"CST \"03\" (COFINS por quantidade): quantidade vendida na unidade de tributação da COFINS (transmitida como qBCProd). O motor é passthrough: NÃO deriva este valor de \"items[].quantidade\" (a quantidade comercial), que pode divergir da tributável","type":"number","x-leiaute":{"tag":"qBCProd","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","tamanho":"12v0-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com valorAliquotaUnidade e valor no CST 03 (tributado por quantidade). Não existe nos demais CST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS/COFINSQtde/qBCProd (TDec_1204v)"},"uniqueKey":"\\items.items.[INDEX].cofins.quantidadeVendida","typeLabel":"number"},"valorAliquotaUnidade":{"description":"CST \"03\" (COFINS por quantidade): alíquota da COFINS em R$ por unidade de produto (transmitida como vAliqProd)","type":"number","x-leiaute":{"tag":"vAliqProd","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","tamanho":"11v0-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com quantidadeVendida e valor no CST 03 (tributado por quantidade). Não existe nos demais CST.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS/COFINSQtde/vAliqProd (TDec_1104v)"},"uniqueKey":"\\items.items.[INDEX].cofins.valorAliquotaUnidade","typeLabel":"number"},"valor":{"description":"Valor da COFINS em R$ (transmitido como vCOFINS e somado no total da nota). Comum aos dois grupos (alíquota e quantidade)","type":"number","x-leiaute":{"tag":"vCOFINS","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST que carregam valores, seja por ALÍQUOTA (base + alíquota) seja por QUANTIDADE (quantidadeVendida + valorAliquotaUnidade, CST 03). Soma no total da nota (tag de mesmo nome no grupo de totais), mas não compõe o valor a pagar.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS/COFINSAliq/vCOFINS (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].cofins.valor","typeLabel":"number"}},"additionalProperties":false,"x-leiaute":{"tag":"COFINS","grupo":"COFINS: Contribuição para Financiamento da Seguridade Social","obrigatoriedadeLeiaute":"C","condicao":"O leiaute marca o grupo como opcional na estrutura. A engineAPI o emite SEMPRE: item que não informa o tributo sai com CST 99 e valores zerados, em vez de sair sem o grupo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/COFINS (choice entre COFINSAliq, COFINSQtde, COFINSNT e COFINSOutr)","naoMapeado":"Grupo, não campo: o leiaute escolhe o subgrupo pelo CST informado, e é o subgrupo que carrega as tags."},"uniqueKey":"\\items.items.[INDEX].cofins","typeLabel":"object"},"ipi":{"description":"Tributação de IPI do item (indústria/importação). Só na NF-e: a NFC-e não tem IPI no leiaute. O valor informado compõe o total da nota","type":"object","properties":{"cst":{"description":"Código de Situação Tributária do IPI (obrigatório quando o grupo ipi é enviado). Tributados: \"00\", \"49\", \"50\", \"99\" (exigem, ALTERNATIVAMENTE: baseCalculo+aliquota OU quantidadeUnidadeTributavel+valorUnidadeTributavel, mais valor). Não tributados: \"01\"..\"05\" e \"51\"..\"55\" (só o CST vai no documento)","type":"string","pattern":"^\\d{1,3}$","x-leiaute":{"tag":"CST","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"2","obrigatoriedadeLeiaute":"O","condicao":"Tributados (subgrupo IPITrib, exigem base, alíquota e valor): 00, 49, 50 e 99. Não tributados (subgrupo IPINT, só o CST vai no documento): 01 a 05 e 51 a 55.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/IPITrib/CST e TIpi/IPINT/CST"},"uniqueKey":"\\items.items.[INDEX].ipi.cst","typeLabel":"string"},"baseCalculo":{"description":"Base de cálculo do IPI em R$ (transmitida como vBC). Grupo por ALÍQUOTA: não combina com quantidadeUnidadeTributavel/valorUnidadeTributavel no mesmo item","type":"number","x-leiaute":{"tag":"vBC","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória nos CST tributados (00, 49, 50, 99) quando o item é tributado por ALÍQUOTA; não combina com quantidadeUnidadeTributavel/valorUnidadeTributavel no mesmo item (o leiaute é um choice entre os dois pares).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/IPITrib/vBC (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].ipi.baseCalculo","typeLabel":"number"},"aliquota":{"description":"Alíquota do IPI em % (transmitida como pIPI). Grupo por ALÍQUOTA: não combina com quantidadeUnidadeTributavel/valorUnidadeTributavel no mesmo item","type":"number","x-leiaute":{"tag":"pIPI","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória nos CST tributados, junto com a base, quando o item é tributado por ALÍQUOTA; não combina com quantidadeUnidadeTributavel/valorUnidadeTributavel no mesmo item.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/IPITrib/pIPI (TDec_0302a04)"},"uniqueKey":"\\items.items.[INDEX].ipi.aliquota","typeLabel":"number"},"quantidadeUnidadeTributavel":{"description":"IPI tributado por pauta/unidade (ex.: cigarro, bebida): quantidade total na unidade padrão de tributação do IPI (transmitida como qUnid). Grupo por QUANTIDADE: não combina com baseCalculo/aliquota no mesmo item. O motor é passthrough: NÃO deriva este valor de \"items[].quantidade\" (a quantidade comercial), que pode divergir da tributável","type":"number","x-leiaute":{"tag":"qUnid","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"12v0-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com valorUnidadeTributavel e valor nos CST tributados (00, 49, 50, 99) quando o item é tributado por QUANTIDADE/pauta (ex.: cigarro, bebida); não combina com baseCalculo/aliquota no mesmo item.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/IPITrib/qUnid (TDec_1204v)"},"uniqueKey":"\\items.items.[INDEX].ipi.quantidadeUnidadeTributavel","typeLabel":"number"},"valorUnidadeTributavel":{"description":"IPI tributado por pauta/unidade: valor do IPI por unidade de medida, em R$ (transmitido como vUnid)","type":"number","x-leiaute":{"tag":"vUnid","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"11v0-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatória junto com quantidadeUnidadeTributavel e valor nos CST tributados quando o item é tributado por QUANTIDADE/pauta.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/IPITrib/vUnid (TDec_1104)"},"uniqueKey":"\\items.items.[INDEX].ipi.valorUnidadeTributavel","typeLabel":"number"},"valor":{"description":"Valor do IPI em R$ (transmitido como vIPI). Comum aos dois grupos (alíquota e quantidade). Atenção: o IPI COMPÕE o total da nota: vNF = produtos + IPI, e os pagamentos precisam fechar com esse total","type":"number","x-leiaute":{"tag":"vIPI","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório nos CST tributados, seja por ALÍQUOTA (base + alíquota) seja por QUANTIDADE/pauta (quantidadeUnidadeTributavel + valorUnidadeTributavel). Atenção: o IPI COMPÕE o total da nota (vNF = produtos - desconto + frete + seguro + outras despesas + IPI), então os pagamentos precisam fechar com esse total.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/IPITrib/vIPI (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].ipi.valor","typeLabel":"number"},"cEnq":{"description":"Código de Enquadramento Legal do IPI, 1 a 3 dígitos (tabela da Receita). Ausente = \"999\" (demais casos)","type":"string","x-leiaute":{"tag":"cEnq","grupo":"IPI: Imposto sobre Produtos Industrializados","tamanho":"1-3","obrigatoriedadeLeiaute":"O","condicao":"Código de Enquadramento Legal do IPI (tabela da Receita Federal). Ausente = 999 (demais casos), escrito explicitamente pela engineAPI.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TIpi/cEnq"},"uniqueKey":"\\items.items.[INDEX].ipi.cEnq","typeLabel":"string"}},"additionalProperties":false,"x-leiaute":{"tag":"IPI","grupo":"IPI: Imposto sobre Produtos Industrializados","obrigatoriedadeLeiaute":"C","condicao":"Grupo do leiaute exigido de indústria e de importador equiparado a industrial.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/imposto/IPI (TIpi, choice entre IPITrib e IPINT)","naoMapeado":"Grupo, não campo: o leiaute escolhe entre IPITrib e IPINT pelo CST, e é o subgrupo que carrega as tags de valor."},"uniqueKey":"\\items.items.[INDEX].ipi","typeLabel":"object"},"ibsCbs":{"oneOf":[{"type":"object","description":"Grupo IBS/CBS da Reforma Tributária (opcional, NT 2025.002). Aceita o grupo completo (passthrough) ou só { cClassTrib }; nesse caso o Cérebro Fiscal resolve os percentuais oficiais da classe (requer resolverTributacao: true)","required":["ibsUf","ibsMun","cbs"],"x-leiaute":{"tag":"IBSCBS","grupo":"UB: Tributação do IBS e da CBS","obrigatoriedadeLeiaute":"OC","condicao":"Grupo da Reforma Tributária (NT 2025.002). Aceita o grupo completo (passthrough) ou só { cClassTrib }; nesse segundo formato o Cérebro Fiscal resolve os percentuais oficiais da classe e exige resolverTributacao: true.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TNFe/infNFe/det/imposto/IBSCBS (tipo TTribNFe)","naoMapeado":"Grupo, não campo: IBSCBS é o contêiner do CST, do cClassTrib e dos subgrupos de alíquota."},"properties":{"ibsUf":{"type":"object","properties":{"p":{"type":"number","minimum":0,"description":"Alíquota EFETIVA do componente, em % (ex.: 0.04). É ela que gera o valor do tributo (v = p × vBC). Em item COM redução, vai no documento dentro de gRed/pAliqEfet","x-leiaute":{"tag":"pAliqEfet","tagAlternativa":"pIBSUF","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"O","condicao":"Alíquota EFETIVA do componente estadual do IBS. Em item COM redução ela vai em pAliqEfet, dentro do subgrupo gRed; em item SEM redução ela é a própria pIBSUF (nominal e efetiva coincidem).","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TRed/pAliqEfet e TCIBS/gIBSUF/pIBSUF (TDec_0302_04RTC)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsUf.p","typeLabel":"number"},"pNominal":{"description":"Alíquota NOMINAL do componente, em % (ex.: 0.1). É a alíquota cheia, antes da redução do cClassTrib, e a que o documento grava em pIBSUF/pIBSMun/pCBS. Obrigatória junto com pRedAliq; ausente = item sem redução (nominal = efetiva)","type":"number","minimum":0,"x-leiaute":{"tag":"pIBSUF","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"O","condicao":"Alíquota NOMINAL (cheia, antes da redução do cClassTrib). É o que o documento grava em pIBSUF. Obrigatória junto com pRedAliq; ausente = item sem redução, e a efetiva é gravada como nominal.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gIBSUF/pIBSUF (TDec_0302_04RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsUf.pNominal","typeLabel":"number"},"pRedAliq":{"description":"Percentual de redução de alíquota do cClassTrib, em % (ex.: 60 para o Anexo VII). Presente e maior que 0 faz o documento emitir o grupo gRed{pRedAliq, pAliqEfet}. Obrigatória junto com pNominal","type":"number","minimum":0,"maximum":100,"x-leiaute":{"tag":"pRedAliq","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Percentual de redução de alíquota do cClassTrib. Presente e maior que zero faz o documento emitir o subgrupo gRed{pRedAliq, pAliqEfet}. Obrigatória junto com pNominal. A SEFAZ valida a redução contra o cClassTrib do item.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TRed/pRedAliq (TDec_0302_04RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsUf.pRedAliq","typeLabel":"number"},"v":{"description":"Valor do componente em R$. Ausente = calculado como p × vBC","type":"number","minimum":0,"x-leiaute":{"tag":"vIBSUF","grupo":"UB: Tributação do IBS e da CBS","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"Valor do componente estadual do IBS. Ausente = calculado pela engineAPI como alíquota efetiva × base do grupo.","preenchimento":"derivado","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gIBSUF/vIBSUF (TDec1302RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsUf.v","typeLabel":"number"}},"required":["p"],"additionalProperties":false,"description":"Componente estadual do IBS (Imposto sobre Bens e Serviços)","x-leiaute":{"tag":"gIBSUF","grupo":"UB: Tributação do IBS e da CBS","obrigatoriedadeLeiaute":"O","condicao":"Subgrupo do componente estadual do IBS. Os três subgrupos são obrigatórios quando o grupo de tributação IBS/CBS existe no item.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gIBSUF","naoMapeado":"Grupo, não campo: o subgrupo é o contêiner da alíquota e do valor do componente."},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsUf","typeLabel":"object"},"ibsMun":{"type":"object","properties":{"p":{"type":"number","minimum":0,"description":"Alíquota EFETIVA do componente, em % (ex.: 0.04). É ela que gera o valor do tributo (v = p × vBC). Em item COM redução, vai no documento dentro de gRed/pAliqEfet","x-leiaute":{"tag":"pAliqEfet","tagAlternativa":"pIBSMun","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"O","condicao":"Alíquota EFETIVA do componente municipal do IBS. Em item COM redução ela vai em pAliqEfet, dentro do subgrupo gRed; em item SEM redução ela é a própria pIBSMun (nominal e efetiva coincidem).","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TRed/pAliqEfet e TCIBS/gIBSMun/pIBSMun (TDec_0302_04RTC)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsMun.p","typeLabel":"number"},"pNominal":{"description":"Alíquota NOMINAL do componente, em % (ex.: 0.1). É a alíquota cheia, antes da redução do cClassTrib, e a que o documento grava em pIBSUF/pIBSMun/pCBS. Obrigatória junto com pRedAliq; ausente = item sem redução (nominal = efetiva)","type":"number","minimum":0,"x-leiaute":{"tag":"pIBSMun","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"O","condicao":"Alíquota NOMINAL (cheia, antes da redução do cClassTrib). É o que o documento grava em pIBSMun. Obrigatória junto com pRedAliq; ausente = item sem redução, e a efetiva é gravada como nominal.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gIBSMun/pIBSMun (TDec_0302_04RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsMun.pNominal","typeLabel":"number"},"pRedAliq":{"description":"Percentual de redução de alíquota do cClassTrib, em % (ex.: 60 para o Anexo VII). Presente e maior que 0 faz o documento emitir o grupo gRed{pRedAliq, pAliqEfet}. Obrigatória junto com pNominal","type":"number","minimum":0,"maximum":100,"x-leiaute":{"tag":"pRedAliq","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Percentual de redução de alíquota do cClassTrib. Presente e maior que zero faz o documento emitir o subgrupo gRed{pRedAliq, pAliqEfet}. Obrigatória junto com pNominal. A SEFAZ valida a redução contra o cClassTrib do item.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TRed/pRedAliq (TDec_0302_04RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsMun.pRedAliq","typeLabel":"number"},"v":{"description":"Valor do componente em R$. Ausente = calculado como p × vBC","type":"number","minimum":0,"x-leiaute":{"tag":"vIBSMun","grupo":"UB: Tributação do IBS e da CBS","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"Valor do componente municipal do IBS. Ausente = calculado pela engineAPI como alíquota efetiva × base do grupo.","preenchimento":"derivado","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gIBSMun/vIBSMun (TDec1302RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsMun.v","typeLabel":"number"}},"required":["p"],"additionalProperties":false,"description":"Componente municipal do IBS","x-leiaute":{"tag":"gIBSMun","grupo":"UB: Tributação do IBS e da CBS","obrigatoriedadeLeiaute":"O","condicao":"Subgrupo do componente municipal do IBS. Os três subgrupos são obrigatórios quando o grupo de tributação IBS/CBS existe no item.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gIBSMun","naoMapeado":"Grupo, não campo: o subgrupo é o contêiner da alíquota e do valor do componente."},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.ibsMun","typeLabel":"object"},"cbs":{"type":"object","properties":{"p":{"type":"number","minimum":0,"description":"Alíquota EFETIVA do componente, em % (ex.: 0.04). É ela que gera o valor do tributo (v = p × vBC). Em item COM redução, vai no documento dentro de gRed/pAliqEfet","x-leiaute":{"tag":"pAliqEfet","tagAlternativa":"pCBS","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"O","condicao":"Alíquota EFETIVA do CBS, o componente federal. Em item COM redução ela vai em pAliqEfet, dentro do subgrupo gRed; em item SEM redução ela é a própria pCBS (nominal e efetiva coincidem).","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TRed/pAliqEfet e TCIBS/gCBS/pCBS (TDec_0302_04RTC)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cbs.p","typeLabel":"number"},"pNominal":{"description":"Alíquota NOMINAL do componente, em % (ex.: 0.1). É a alíquota cheia, antes da redução do cClassTrib, e a que o documento grava em pIBSUF/pIBSMun/pCBS. Obrigatória junto com pRedAliq; ausente = item sem redução (nominal = efetiva)","type":"number","minimum":0,"x-leiaute":{"tag":"pCBS","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"O","condicao":"Alíquota NOMINAL (cheia, antes da redução do cClassTrib). É o que o documento grava em pCBS. Obrigatória junto com pRedAliq; ausente = item sem redução, e a efetiva é gravada como nominal.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gCBS/pCBS (TDec_0302_04RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cbs.pNominal","typeLabel":"number"},"pRedAliq":{"description":"Percentual de redução de alíquota do cClassTrib, em % (ex.: 60 para o Anexo VII). Presente e maior que 0 faz o documento emitir o grupo gRed{pRedAliq, pAliqEfet}. Obrigatória junto com pNominal","type":"number","minimum":0,"maximum":100,"x-leiaute":{"tag":"pRedAliq","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Percentual de redução de alíquota do cClassTrib. Presente e maior que zero faz o documento emitir o subgrupo gRed{pRedAliq, pAliqEfet}. Obrigatória junto com pNominal. A SEFAZ valida a redução contra o cClassTrib do item.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TRed/pRedAliq (TDec_0302_04RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cbs.pRedAliq","typeLabel":"number"},"v":{"description":"Valor do componente em R$. Ausente = calculado como p × vBC","type":"number","minimum":0,"x-leiaute":{"tag":"vCBS","grupo":"UB: Tributação do IBS e da CBS","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"Valor do CBS, o componente federal. Ausente = calculado pela engineAPI como alíquota efetiva × base do grupo.","preenchimento":"derivado","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gCBS/vCBS (TDec1302RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cbs.v","typeLabel":"number"}},"required":["p"],"additionalProperties":false,"description":"CBS (Contribuição sobre Bens e Serviços, componente federal)","x-leiaute":{"tag":"gCBS","grupo":"UB: Tributação do IBS e da CBS","obrigatoriedadeLeiaute":"O","condicao":"Subgrupo do CBS, o componente federal. Os três subgrupos são obrigatórios quando o grupo de tributação IBS/CBS existe no item.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/gCBS","naoMapeado":"Grupo, não campo: o subgrupo é o contêiner da alíquota e do valor do componente."},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cbs","typeLabel":"object"},"cst":{"description":"Código de Situação Tributária do IBS/CBS (Reforma Tributária). Ausente = \"000\"","type":"string","pattern":"^\\d{1,3}$","x-leiaute":{"tag":"CST","grupo":"UB: Tributação do IBS e da CBS","tamanho":"3","obrigatoriedadeLeiaute":"O","condicao":"Código de Situação Tributária do IBS/CBS, 3 dígitos exatos no leiaute. Ausente = 000 (tributação integral).","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TTribNFe/CST (TCST)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cst","typeLabel":"string"},"cClassTrib":{"description":"Código de Classificação Tributária do IBS/CBS. Ausente = \"000001\" (tributação integral)","type":"string","pattern":"^\\d{1,6}$","x-leiaute":{"tag":"cClassTrib","grupo":"UB: Tributação do IBS e da CBS","tamanho":"6","obrigatoriedadeLeiaute":"O","condicao":"Código de Classificação Tributária do IBS/CBS, 6 dígitos exatos no leiaute. Ausente = 000001 (tributação integral). Sozinho no grupo, vira a dica de classe que o Cérebro Fiscal resolve.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TTribNFe/cClassTrib (TcClassTrib)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.cClassTrib","typeLabel":"string"},"vBC":{"description":"Base de cálculo do IBS/CBS em R$. Ausente = vProd − desconto + valorFrete + valorSeguro + outrasDespesas do item (LC 214/2025 art. 12 § 1º III soma frete/seguro/outras despesas; art. 12 § 2º III: descontos incondicionais não integram a base)","type":"number","minimum":0,"x-leiaute":{"tag":"vBC","grupo":"UB: Tributação do IBS e da CBS","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"Base de cálculo do IBS/CBS. Ausente = valor do produto menos desconto incondicional, mais frete, seguro e outras despesas do item.","preenchimento":"derivado","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/vBC (TDec1302RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.vBC","typeLabel":"number"},"vIbs":{"description":"Valor total do IBS em R$ (UF + Município). Ausente = vIbsUf + vIbsMun","type":"number","minimum":0,"x-leiaute":{"tag":"vIBS","grupo":"UB: Tributação do IBS e da CBS","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"Valor total do IBS do item (estadual + municipal). Ausente = soma dos dois componentes.","preenchimento":"derivado","fonte":"DFeTiposBasicos_v1.00.xsd: TCIBS/vIBS (TDec1302RTC)"},"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0.vIbs","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.0","typeLabel":"object"},{"type":"object","description":"Grupo IBS/CBS da Reforma Tributária (opcional, NT 2025.002). Aceita o grupo completo (passthrough) ou só { cClassTrib }; nesse caso o Cérebro Fiscal resolve os percentuais oficiais da classe (requer resolverTributacao: true)","required":["cClassTrib"],"x-leiaute":{"tag":"IBSCBS","grupo":"UB: Tributação do IBS e da CBS","obrigatoriedadeLeiaute":"OC","condicao":"Grupo da Reforma Tributária (NT 2025.002). Aceita o grupo completo (passthrough) ou só { cClassTrib }; nesse segundo formato o Cérebro Fiscal resolve os percentuais oficiais da classe e exige resolverTributacao: true.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TNFe/infNFe/det/imposto/IBSCBS (tipo TTribNFe)","naoMapeado":"Grupo, não campo: IBSCBS é o contêiner do CST, do cClassTrib e dos subgrupos de alíquota."},"properties":{"cClassTrib":{"type":"string","pattern":"^\\d{1,6}$","description":"Classe de tributação IBS/CBS a estampar no item. O motor busca os percentuais oficiais dela para o NCM e recusa (422) se a classe não valer para este NCM ou para o modelo do documento. Requer resolverTributacao: true. Neste formato NENHUM outro campo do grupo é aceito; inclusive vBC, que hoje é sempre o vProd do item","x-leiaute":{"tag":"cClassTrib","grupo":"UB: Tributação do IBS e da CBS","tamanho":"6","obrigatoriedadeLeiaute":"O","condicao":"Código de Classificação Tributária do IBS/CBS, 6 dígitos exatos no leiaute. Ausente = 000001 (tributação integral). Sozinho no grupo, vira a dica de classe que o Cérebro Fiscal resolve.","preenchimento":"integrador","fonte":"DFeTiposBasicos_v1.00.xsd: TTribNFe/cClassTrib (TcClassTrib)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.1.cClassTrib","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX].ibsCbs.oneOf.1","typeLabel":"object"}],"uniqueKey":"\\items.items.[INDEX].ibsCbs","typeLabel":"object"},"combustivel":{"description":"Grupo de combustíveis do leiaute (comb/LA). Obrigatório quando o CFOP do item é de operação com combustível (rejeição 660 da SEFAZ): sem ele a emissão é recusada com 422 COMBUSTIVEL_GRUPO_OBRIGATORIO. Passthrough: o motor não calcula nada aqui","type":"object","properties":{"cProdANP":{"type":"string","pattern":"^\\d{9}$","description":"Código do produto na tabela SIMP da ANP, 9 dígitos (ex.: \"210203001\" para GLP). Código inexistente na tabela da ANP é rejeitado pela SEFAZ (cStat 761)","x-leiaute":{"tag":"cProdANP","grupo":"LA: Combustível","tamanho":"9","obrigatoriedadeLeiaute":"O","condicao":"Código do produto na tabela SIMP da ANP. Código inexistente na tabela é rejeitado pela SEFAZ (cStat 761).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/cProdANP"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].combustivel.cProdANP","typeLabel":"string"},"descANP":{"type":"string","minLength":2,"maxLength":95,"description":"Descrição do produto conforme a ANP (tabela SIMP), 2 a 95 caracteres (ex.: \"GLP\")","x-leiaute":{"tag":"descANP","grupo":"LA: Combustível","tamanho":"2-95","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/descANP"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].combustivel.descANP","typeLabel":"string"},"ufConsumo":{"type":"string","minLength":2,"maxLength":2,"description":"Sigla da UF de consumo do combustível (campo UFCons do leiaute, obrigatório). Use \"EX\" para exterior","x-leiaute":{"tag":"UFCons","grupo":"LA: Combustível","tamanho":"2","obrigatoriedadeLeiaute":"O","valores":[{"valor":"AC","significado":"Unidade federativa AC"},{"valor":"AL","significado":"Unidade federativa AL"},{"valor":"AM","significado":"Unidade federativa AM"},{"valor":"AP","significado":"Unidade federativa AP"},{"valor":"BA","significado":"Unidade federativa BA"},{"valor":"CE","significado":"Unidade federativa CE"},{"valor":"DF","significado":"Unidade federativa DF"},{"valor":"ES","significado":"Unidade federativa ES"},{"valor":"GO","significado":"Unidade federativa GO"},{"valor":"MA","significado":"Unidade federativa MA"},{"valor":"MG","significado":"Unidade federativa MG"},{"valor":"MS","significado":"Unidade federativa MS"},{"valor":"MT","significado":"Unidade federativa MT"},{"valor":"PA","significado":"Unidade federativa PA"},{"valor":"PB","significado":"Unidade federativa PB"},{"valor":"PE","significado":"Unidade federativa PE"},{"valor":"PI","significado":"Unidade federativa PI"},{"valor":"PR","significado":"Unidade federativa PR"},{"valor":"RJ","significado":"Unidade federativa RJ"},{"valor":"RN","significado":"Unidade federativa RN"},{"valor":"RO","significado":"Unidade federativa RO"},{"valor":"RR","significado":"Unidade federativa RR"},{"valor":"RS","significado":"Unidade federativa RS"},{"valor":"SC","significado":"Unidade federativa SC"},{"valor":"SE","significado":"Unidade federativa SE"},{"valor":"SP","significado":"Unidade federativa SP"},{"valor":"TO","significado":"Unidade federativa TO"},{"valor":"EX","significado":"Exterior"}],"condicao":"Sigla da UF de consumo do combustível. Use EX para exterior.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/UFCons (TUf)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].combustivel.ufConsumo","typeLabel":"string"},"pGLP":{"description":"Percentual do GLP derivado de petróleo no produto, 0 a 100. SÓ para cProdANP \"210203001\" (GLP); em outro produto a emissão é recusada com 422 COMBUSTIVEL_INVALIDO (a SEFAZ rejeitaria com cStat 461)","type":"number","minimum":0,"maximum":100,"x-leiaute":{"tag":"pGLP","grupo":"LA: Combustível","tamanho":"3v2-4 (0 a 100)","obrigatoriedadeLeiaute":"C","condicao":"Só existe para GLP (cProdANP 210203001). Em outro produto a emissão é recusada com 422 COMBUSTIVEL_INVALIDO (a SEFAZ rejeitaria com cStat 461). A soma pGLP + pGNn + pGNi tem que dar 100 (cStat 855).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/pGLP (TDec_0302a04Max100)"},"uniqueKey":"\\items.items.[INDEX].combustivel.pGLP","typeLabel":"number"},"pGNn":{"description":"Percentual de gás natural NACIONAL (GLGNn) no produto GLP, 0 a 100. Mesma restrição de pGLP","type":"number","minimum":0,"maximum":100,"x-leiaute":{"tag":"pGNn","grupo":"LA: Combustível","tamanho":"3v2-4 (0 a 100)","obrigatoriedadeLeiaute":"C","condicao":"Percentual de gás natural NACIONAL no GLP. Mesma restrição de pGLP: só para cProdANP 210203001, e a soma dos três percentuais tem que dar 100.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/pGNn (TDec_0302a04Max100)"},"uniqueKey":"\\items.items.[INDEX].combustivel.pGNn","typeLabel":"number"},"pGNi":{"description":"Percentual de gás natural IMPORTADO (GLGNi) no produto GLP, 0 a 100. Mesma restrição de pGLP. Regra da SEFAZ: pGLP + pGNn + pGNi = 100 (cStat 855)","type":"number","minimum":0,"maximum":100,"x-leiaute":{"tag":"pGNi","grupo":"LA: Combustível","tamanho":"3v2-4 (0 a 100)","obrigatoriedadeLeiaute":"C","condicao":"Percentual de gás natural IMPORTADO no GLP. Mesma restrição de pGLP: só para cProdANP 210203001, e a soma dos três percentuais tem que dar 100.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/pGNi (TDec_0302a04Max100)"},"uniqueKey":"\\items.items.[INDEX].combustivel.pGNi","typeLabel":"number"},"vPart":{"description":"Valor de partida em R$ por quilograma, SEM ICMS. Obrigatório para GLP (cStat 856) e aceito apenas nele","type":"number","minimum":0,"x-leiaute":{"tag":"vPart","grupo":"LA: Combustível","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Valor de partida por quilograma, sem ICMS. Obrigatório para GLP (cStat 856) e aceito apenas nele.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb/vPart (TDec_1302)"},"uniqueKey":"\\items.items.[INDEX].combustivel.vPart","typeLabel":"number"}},"required":["cProdANP","descANP","ufConsumo"],"additionalProperties":false,"x-leiaute":{"tag":"comb","grupo":"LA: Combustível","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório quando o CFOP do item é de operação com combustível (a Tabela CFOP marca esses códigos com indComb 1 ou 2). Sem o grupo a emissão é recusada com 422 COMBUSTIVEL_GRUPO_OBRIGATORIO, antes de a SEFAZ rejeitar com cStat 660.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/comb","naoMapeado":"Grupo, não campo: comb é o contêiner do detalhamento específico de combustíveis."},"uniqueKey":"\\items.items.[INDEX].combustivel","typeLabel":"object"},"gCred":{"description":"Créditos presumidos concedidos pela UF ao item (grupo gCred do leiaute), até 4. Passthrough: o código vem da tabela de benefícios da própria UF","maxItems":4,"type":"array","items":{"type":"object","properties":{"cCredPresumido":{"type":"string","description":"Código do benefício fiscal de crédito presumido na UF aplicado ao item, 8 ou 10 caracteres alfanuméricos (ex.: \"GO810003\")","x-leiaute":{"tag":"cCredPresumido","grupo":"I: Produtos e Serviços","tamanho":"8 ou 10","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo de crédito presumido. É o código do crédito na tabela da sua UF. A engineAPI confere o FORMATO; conferir se o código existe na tabela é responsabilidade do emitente.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/gCred/cCredPresumido"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].gCred.items.[INDEX].cCredPresumido","typeLabel":"string"},"pCredPresumido":{"type":"number","minimum":0,"description":"Percentual do crédito presumido, em %","x-leiaute":{"tag":"pCredPresumido","grupo":"I: Produtos e Serviços","tamanho":"3v2-4","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo de crédito presumido: percentual do crédito.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/gCred/pCredPresumido (TDec_0302a04)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].gCred.items.[INDEX].pCredPresumido","typeLabel":"number"},"vCredPresumido":{"type":"number","minimum":0,"description":"Valor do crédito presumido, em R$","x-leiaute":{"tag":"vCredPresumido","grupo":"I: Produtos e Serviços","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo de crédito presumido: valor do crédito.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/gCred/vCredPresumido (TDec_1302)"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].gCred.items.[INDEX].vCredPresumido","typeLabel":"number"}},"required":["cCredPresumido","pCredPresumido","vCredPresumido"],"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX].gCred.items.[INDEX]","typeLabel":"object"},"x-leiaute":{"tag":"gCred","grupo":"I: Produtos e Serviços","obrigatoriedadeLeiaute":"OC","condicao":"Créditos presumidos concedidos pela UF ao item, até 4 por item no leiaute. Uma entrada do array vira um grupo gCred do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/prod/gCred (minOccurs=\"0\" maxOccurs=\"4\")"},"uniqueKey":"\\items.items.[INDEX].gCred","typeLabel":"object[]"},"documentoReferenciado":{"description":"Referência por item na devolução (grupo DFeReferenciado, NT 2025.002-RTC VC). Obrigatório na prática em finNFe 4: informe nItem da nota original; chaveAcesso pode vir do cabeçalho referenciadas[]","type":"object","properties":{"nItem":{"type":"integer","minimum":1,"maximum":999,"description":"Número do item (nItem) na nota ORIGINAL referenciada, 1 a 999; corresponde ao atributo nItem do det da nota de origem (NT 2025.002-RTC VC03)","x-leiaute":{"tag":"nItem","grupo":"I: Produtos e Serviços","tamanho":"1-3","obrigatoriedadeLeiaute":"OC","condicao":"Número do item (nItem) na nota ORIGINAL, 1 a 999; corresponde ao atributo nItem do det da nota referenciada (NT 2025.002-RTC VC03).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/DFeReferenciado/nItem"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].documentoReferenciado.nItem","typeLabel":"integer"},"chaveAcesso":{"description":"Chave de acesso da nota original (44 dígitos). Ausente: usa \"referenciadas[0].chaveAcesso\" do cabeçalho quando informado","type":"string","pattern":"^\\d{44}$","x-leiaute":{"tag":"chaveAcesso","grupo":"I: Produtos e Serviços","tamanho":"44","obrigatoriedadeLeiaute":"C","condicao":"Chave da nota original referenciada. Ausente no item: usa referenciadas[0].chaveAcesso do cabeçalho.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/DFeReferenciado/chaveAcesso (TChNFe)"},"uniqueKey":"\\items.items.[INDEX].documentoReferenciado.chaveAcesso","typeLabel":"string"}},"required":["nItem"],"additionalProperties":false,"x-leiaute":{"tag":"DFeReferenciado","grupo":"I: Produtos e Serviços","obrigatoriedadeLeiaute":"OC","condicao":"Referência por item na devolução (finNFe 4). Obrigatório na prática: NT 2025.002-RTC VC03-20 (Msg 1048). Só se aplica à devolução.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det/DFeReferenciado (grupo VC, Pai=H01)"},"uniqueKey":"\\items.items.[INDEX].documentoReferenciado","typeLabel":"object"}},"required":["codigo","descricao","ncm","cfop","unidade","quantidade","valorUnitario"],"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"description":"Itens da nota (mínimo 1). Atenção: o campo é \"items\", não \"itens\"","x-leiaute":{"tag":"det","grupo":"I: Produtos e Serviços","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/det (maxOccurs=\"990\")","naoMapeado":"Grupo, não campo: `det` é o contêiner do item e não carrega valor próprio (só o atributo nItem, gerado pela ordem do array)."},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"pagamentos":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"forma":{"type":"string","enum":["10","11","12","13","14","15","16","17","18","19","20","21","22","90","98","99","01","02","03","04","05"],"description":"Código da forma de pagamento SEFAZ (ex.: \"01\" dinheiro, \"03\" cartão de crédito, \"15\" boleto)","x-leiaute":{"tag":"tPag","grupo":"pag: Informações de Pagamento","tamanho":"2","obrigatoriedadeLeiaute":"O","valores":[{"valor":"01","significado":"Dinheiro"},{"valor":"02","significado":"Cheque"},{"valor":"03","significado":"Cartão de crédito"},{"valor":"04","significado":"Cartão de débito"},{"valor":"05","significado":"Cartão da loja (private label)"},{"valor":"10","significado":"Vale alimentação"},{"valor":"11","significado":"Vale refeição"},{"valor":"12","significado":"Vale presente"},{"valor":"13","significado":"Vale combustível"},{"valor":"14","significado":"Duplicata mercantil"},{"valor":"15","significado":"Boleto bancário"},{"valor":"16","significado":"Depósito bancário"},{"valor":"17","significado":"PIX dinâmico"},{"valor":"18","significado":"Transferência bancária ou carteira digital"},{"valor":"19","significado":"Programa de fidelidade, cashback ou crédito virtual"},{"valor":"20","significado":"PIX estático"},{"valor":"21","significado":"Crédito em loja"},{"valor":"22","significado":"Falha de hardware do sistema emissor"},{"valor":"90","significado":"Sem pagamento"},{"valor":"98","significado":"Regime especial NFF"},{"valor":"99","significado":"Outro"}],"condicao":"O leiaute só restringe o formato a 2 dígitos; a lista fechada acima é a que a engineAPI valida, porque o motor fiscal converte código desconhecido em 01 (dinheiro) sem avisar.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/tPag (o XSD só restringe o formato; a lista de códigos é a do MOC)"},"isRequired":true,"uniqueKey":"pagamentos.items.[INDEX].forma","typeLabel":"enum\u003cstring>"},"valor":{"type":"number","minimum":0,"description":"Valor pago nesta forma, em R$ (máximo 2 casas decimais)","x-leiaute":{"tag":"vPag","grupo":"pag: Informações de Pagamento","tamanho":"13v2","obrigatoriedadeLeiaute":"O","condicao":"Cada entrada vira uma tag vPag própria, com 2 casas decimais. O leiaute permite omitir só quando a forma é 90 (sem pagamento).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/vPag (TDec_1302)"},"isRequired":true,"uniqueKey":"pagamentos.items.[INDEX].valor","typeLabel":"number"},"indicador":{"oneOf":[{"type":"number","description":"Indicador da forma de pagamento (tag indPag do leiaute): 0 = pagamento à vista; 1 = pagamento a prazo. Ausente mantém a tag omitida, exceto na venda a prazo com cobranca, em que o serviço assume 1.","const":0,"x-leiaute":{"tag":"indPag","grupo":"pag: Informações de Pagamento","tamanho":"1","obrigatoriedadeLeiaute":"OC","valores":[{"valor":"0","significado":"Pagamento à vista"},{"valor":"1","significado":"Pagamento a prazo"}],"condicao":"Opcional. Na NF-e com cobranca contendo fatura ou duplicatas, ausente = 1 (a prazo), preenchido pelo serviço; fora desse cenário, ausente mantém a tag omitida. Valor explícito do integrador sempre vence o default.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/indPag (minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].indicador.oneOf.0","typeLabel":"number"},{"type":"number","description":"Indicador da forma de pagamento (tag indPag do leiaute): 0 = pagamento à vista; 1 = pagamento a prazo. Ausente mantém a tag omitida, exceto na venda a prazo com cobranca, em que o serviço assume 1.","const":1,"x-leiaute":{"tag":"indPag","grupo":"pag: Informações de Pagamento","tamanho":"1","obrigatoriedadeLeiaute":"OC","valores":[{"valor":"0","significado":"Pagamento à vista"},{"valor":"1","significado":"Pagamento a prazo"}],"condicao":"Opcional. Na NF-e com cobranca contendo fatura ou duplicatas, ausente = 1 (a prazo), preenchido pelo serviço; fora desse cenário, ausente mantém a tag omitida. Valor explícito do integrador sempre vence o default.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/indPag (minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].indicador.oneOf.1","typeLabel":"number"}],"uniqueKey":"pagamentos.items.[INDEX].indicador","typeLabel":"number"},"cartao":{"description":"Grupo cartao do leiaute (tag card): dados do meio de pagamento eletrônico. Obrigatório para forma \"03\" (crédito), \"04\" (débito) e \"17\" (PIX), com ao menos tpIntegra; os demais campos são opcionais e validados quando informados. Aceito também para \"10\"/\"11\"/\"12\"/\"13\"/\"15\"/\"18\".","type":"object","properties":{"tpIntegra":{"oneOf":[{"type":"number","description":"Tipo de integração do pagamento (tag tpIntegra do leiaute): 1 = integrado (TEF, e-commerce, POS integrado); 2 = não integrado (POS simples). Único campo obrigatório do grupo cartao.","const":1,"x-leiaute":{"tag":"tpIntegra","grupo":"pag: Informações de Pagamento","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"Pagamento integrado com o sistema de automação (TEF, e-commerce, POS integrado)"},{"valor":"2","significado":"Pagamento não integrado (POS simples)"}],"condicao":"Obrigatório sempre que o grupo card existe. 1 = integrado; 2 = não integrado.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/tpIntegra"},"isRequired":true,"uniqueKey":"pagamentos.items.[INDEX].cartao.tpIntegra.oneOf.0","typeLabel":"number"},{"type":"number","description":"Tipo de integração do pagamento (tag tpIntegra do leiaute): 1 = integrado (TEF, e-commerce, POS integrado); 2 = não integrado (POS simples). Único campo obrigatório do grupo cartao.","const":2,"x-leiaute":{"tag":"tpIntegra","grupo":"pag: Informações de Pagamento","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"Pagamento integrado com o sistema de automação (TEF, e-commerce, POS integrado)"},{"valor":"2","significado":"Pagamento não integrado (POS simples)"}],"condicao":"Obrigatório sempre que o grupo card existe. 1 = integrado; 2 = não integrado.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/tpIntegra"},"isRequired":true,"uniqueKey":"pagamentos.items.[INDEX].cartao.tpIntegra.oneOf.1","typeLabel":"number"}],"isRequired":true,"uniqueKey":"pagamentos.items.[INDEX].cartao.tpIntegra","typeLabel":"number"},"cnpjInstituicao":{"description":"CNPJ da instituição de pagamento (tag CNPJ do leiaute, 14 dígitos). Opcional; obrigatório na recusa de negócio quando tpIntegra=1.","type":"string","minLength":14,"maxLength":14,"pattern":"^\\d{14}$","x-leiaute":{"tag":"CNPJ","grupo":"pag: Informações de Pagamento","tamanho":"14","obrigatoriedadeLeiaute":"OC","condicao":"CNPJ da instituição de pagamento (adquirente ou subadquirente). Opcional no contrato e no XSD (minOccurs=0). Recusa de negócio quando tpIntegra=1 sem este campo (grupo inconsistente).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/CNPJ (TCnpj, minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].cartao.cnpjInstituicao","typeLabel":"string"},"bandeira":{"description":"Bandeira da operadora de cartão (tag tBand). Gate: 2 dígitos [0-9]{2} (XSD v4.00). Tabela YA06 do Portal Nacional (aviso, não recusa 400): 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 99. PIX sem operadora: \"99\".","type":"string","pattern":"^[0-9]{2}$","x-leiaute":{"tag":"tBand","grupo":"pag: Informações de Pagamento","tamanho":"2","obrigatoriedadeLeiaute":"OC","condicao":"Código da Tabela de Operadoras do Portal Nacional (YA06). Gate do contrato = XSD v4.00 pattern [0-9]{2}; a tabela 01–27+99 é aviso/documentação, nunca 400 para código fora da lista (a tabela muda sem mudar leiaute). Opcional (minOccurs=0).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/tBand (pattern [0-9]{2}, minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].cartao.bandeira","typeLabel":"string"},"autorizacao":{"description":"Número de autorização da operação com cartão/PIX (tag cAut do leiaute, 1 a 128 caracteres). Opcional.","type":"string","minLength":1,"maxLength":128,"x-leiaute":{"tag":"cAut","grupo":"pag: Informações de Pagamento","tamanho":"1-128","obrigatoriedadeLeiaute":"OC","condicao":"Número de autorização da operação com cartão, PIX, boleto ou outro pagamento eletrônico. Opcional no contrato e no XSD (minOccurs=0). PIX estático (chave copia-e-cola) não tem cAut.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/cAut (minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].cartao.autorizacao","typeLabel":"string"},"cnpjRecebedor":{"description":"CNPJ do beneficiário do pagamento (tag CNPJReceb do leiaute, opcional, 14 dígitos)","type":"string","minLength":14,"maxLength":14,"pattern":"^\\d{14}$","x-leiaute":{"tag":"CNPJReceb","grupo":"pag: Informações de Pagamento","tamanho":"14","obrigatoriedadeLeiaute":"OC","condicao":"CNPJ do estabelecimento beneficiário do pagamento. Opcional.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/CNPJReceb (TCnpj, minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].cartao.cnpjRecebedor","typeLabel":"string"},"idTerminal":{"description":"Identificador do terminal de pagamento (tag idTermPag do leiaute, opcional, 1 a 40 caracteres)","type":"string","minLength":1,"maxLength":40,"x-leiaute":{"tag":"idTermPag","grupo":"pag: Informações de Pagamento","tamanho":"1-40","obrigatoriedadeLeiaute":"OC","condicao":"Identificador do terminal em que o pagamento foi realizado. Opcional.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card/idTermPag (minOccurs=\"0\")"},"uniqueKey":"pagamentos.items.[INDEX].cartao.idTerminal","typeLabel":"string"}},"required":["tpIntegra"],"additionalProperties":false,"x-leiaute":{"tag":"card","grupo":"pag: Informações de Pagamento","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório quando a forma é 03 (crédito), 04 (débito) ou 17 (PIX): NT 2023.004 v1.11 RV YA04-10, rejeição 391. Dentro do grupo só tpIntegra é minOccurs=1 no XSD; os demais campos são opcionais. Aceito também para 10, 11, 12, 13, 15 e 18 (RV YA04-20). Fora dessas formas o builder ignora o grupo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/detPag/card (minOccurs=\"0\")","naoMapeado":"Grupo, não campo: card é o contêiner dos dados do meio de pagamento eletrônico."},"uniqueKey":"pagamentos.items.[INDEX].cartao","typeLabel":"object"}},"required":["forma","valor"],"additionalProperties":false,"uniqueKey":"pagamentos.items.[INDEX]","typeLabel":"object"},"description":"Formas de pagamento (mínimo 1, máximo 100). Atenção: o campo é \"pagamentos\" (array), não \"pagamento\"","x-leiaute":{"tag":"pag","grupo":"pag: Informações de Pagamento","obrigatoriedadeLeiaute":"O","condicao":"Uma entrada do array vira um subgrupo detPag do leiaute (máximo 100). A soma dos valores tem que fechar com o total do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag e /pag/detPag (maxOccurs=\"100\")","naoMapeado":"Grupo, não campo: pag é o contêiner das formas de pagamento e do troco."},"isRequired":true,"uniqueKey":"pagamentos","typeLabel":"object[]"},"issuerId":{"description":"UUID do emissor (retornado por POST /v1/companies). Opcional com 1 emissor cadastrado; obrigatório com 2+","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","x-leiaute":{"tag":null,"grupo":"engineAPI: plataforma","obrigatoriedadeLeiaute":"N","condicao":"Opcional com um emissor cadastrado; obrigatório com dois ou mais (a API não escolhe o CNPJ emitente por conta própria).","preenchimento":"integrador","fonte":"contrato da engineAPI (POST /v1/companies devolve o UUID)","naoMapeado":"Campo de plataforma: identifica qual emissor cadastrado assina o documento. Não existe no leiaute fiscal, onde o emitente é identificado pelo CNPJ no grupo emit."},"uniqueKey":"issuerId","typeLabel":"string\u003cuuid>"},"naturezaOperacao":{"description":"Natureza da operação, texto livre (ex.: \"VENDA DE MERCADORIA\")","type":"string","x-leiaute":{"tag":"natOp","grupo":"ide: Identificação da NF-e","tamanho":"1-60","obrigatoriedadeLeiaute":"O","condicao":"Texto livre. Ausente, a engineAPI escreve \"Venda de Mercadoria\", porque o leiaute exige a tag preenchida.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/natOp"},"uniqueKey":"naturezaOperacao","typeLabel":"string"},"serie":{"description":"Série da NF-e. Ausente = série padrão do emissor","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"serie","grupo":"ide: Identificação da NF-e","tamanho":"1-3 (0 a 999)","obrigatoriedadeLeiaute":"O","condicao":"Ausente = série padrão do emissor. Emitente comum usa 0-889; o leiaute reserva 890-899 para avulsa do Fisco e 900-999 para contingência.","preenchimento":"automatico","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/serie (TSerie)"},"uniqueKey":"serie","typeLabel":"integer"},"numero":{"description":"Número da NF-e (passthrough). Ausente = alocado automaticamente pela engineAPI","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"nNF","grupo":"ide: Identificação da NF-e","tamanho":"1-9","obrigatoriedadeLeiaute":"O","condicao":"Ausente = número alocado pela engineAPI no controle de numeração do emissor. Informar o número é passthrough e a responsabilidade pela sequência passa a ser do integrador.","preenchimento":"automatico","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/nNF (TNF)"},"uniqueKey":"numero","typeLabel":"integer"},"tpNF":{"description":"Tipo de operação: 0=entrada, 1=saída. Padrão: saída","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"tpNF","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Entrada"},{"valor":"1","significado":"Saída"}],"condicao":"Ausente = 1 (saída).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/tpNF"},"uniqueKey":"tpNF","typeLabel":"integer"},"idDest":{"oneOf":[{"type":"number","description":"Identificador de local de destino: 1=interna, 2=interestadual, 3=exterior. Ausente: a API deriva do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). A UF do emissor vem do cadastro da empresa. Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes recusam 422 CFOP_IDDEST_DIVERGENTE nomeando os códigos","const":1,"x-leiaute":{"tag":"idDest","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"Operação interna (mesma UF)"},{"valor":"2","significado":"Operação interestadual"},{"valor":"3","significado":"Operação com o exterior"}],"condicao":"Ausente: derivado do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes: 422 CFOP_IDDEST_DIVERGENTE. A UF do emissor vem do cadastro.","preenchimento":"derivado","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/idDest"},"uniqueKey":"idDest.oneOf.0","typeLabel":"number"},{"type":"number","description":"Identificador de local de destino: 1=interna, 2=interestadual, 3=exterior. Ausente: a API deriva do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). A UF do emissor vem do cadastro da empresa. Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes recusam 422 CFOP_IDDEST_DIVERGENTE nomeando os códigos","const":2,"x-leiaute":{"tag":"idDest","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"Operação interna (mesma UF)"},{"valor":"2","significado":"Operação interestadual"},{"valor":"3","significado":"Operação com o exterior"}],"condicao":"Ausente: derivado do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes: 422 CFOP_IDDEST_DIVERGENTE. A UF do emissor vem do cadastro.","preenchimento":"derivado","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/idDest"},"uniqueKey":"idDest.oneOf.1","typeLabel":"number"},{"type":"number","description":"Identificador de local de destino: 1=interna, 2=interestadual, 3=exterior. Ausente: a API deriva do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). A UF do emissor vem do cadastro da empresa. Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes recusam 422 CFOP_IDDEST_DIVERGENTE nomeando os códigos","const":3,"x-leiaute":{"tag":"idDest","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"Operação interna (mesma UF)"},{"valor":"2","significado":"Operação interestadual"},{"valor":"3","significado":"Operação com o exterior"}],"condicao":"Ausente: derivado do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes: 422 CFOP_IDDEST_DIVERGENTE. A UF do emissor vem do cadastro.","preenchimento":"derivado","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/idDest"},"uniqueKey":"idDest.oneOf.2","typeLabel":"number"}],"uniqueKey":"idDest","typeLabel":"number"},"indFinal":{"description":"Indica operação com consumidor final: 0=não, 1=sim. Ausente: o motor deriva 1 quando o destinatário é não contribuinte (indicadorIE=9 ou CPF), conforme NT 2016.002 da SEFAZ; nos demais casos vale 0. Informar 0 com destinatário não contribuinte recusa com 422 INDFINAL_INCOERENTE_COM_DESTINATARIO antes de numerar","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"indFinal","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Não é operação com consumidor final"},{"valor":"1","significado":"Operação com consumidor final"}],"condicao":"Ausente = 0.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/indFinal"},"uniqueKey":"indFinal","typeLabel":"integer"},"indPres":{"description":"Indicador de presença do comprador: 0=não se aplica, 1=presencial, 2=internet, 3=teleatendimento, etc.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"indPres","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Não se aplica (por exemplo, nota complementar ou de ajuste)"},{"valor":"1","significado":"Operação presencial"},{"valor":"2","significado":"Operação não presencial, pela internet"},{"valor":"3","significado":"Operação não presencial, teleatendimento"},{"valor":"4","significado":"NFC-e com entrega em domicílio"},{"valor":"5","significado":"Operação presencial, fora do estabelecimento"},{"valor":"9","significado":"Operação não presencial, outros"}],"condicao":"Ausente = 1 (presencial).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/indPres"},"uniqueKey":"indPres","typeLabel":"integer"},"finNFe":{"description":"Finalidade da emissão: 1=normal, 2=complementar, 3=ajuste, 4=devolução, 5=nota de crédito, 6=nota de débito. Ausente = 1. As finalidades 2, 3 e 4 exigem \"referenciadas\" (a nota original): sem o grupo a SEFAZ rejeitaria a nota DEPOIS de consumir o número (cStat 254 na finalidade 2, cStat 321 na 4), então a API recusa com 422 FINALIDADE_SEM_NFREF antes de numerar. As finalidades 3 e 4 exigem ainda \"pagamentos\" com forma \"90\" (sem pagamento).","type":"integer","minimum":1,"maximum":6,"x-leiaute":{"tag":"finNFe","grupo":"ide: Identificação da NF-e","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"1","significado":"NF-e normal (a única emitida de ponta a ponta hoje)"},{"valor":"2","significado":"NF-e complementar (exige o campo referenciadas, apontando a nota original)"},{"valor":"3","significado":"NF-e de ajuste (exige referenciadas e forma de pagamento 90, sem pagamento)"},{"valor":"4","significado":"Devolução ou retorno (exige referenciadas e forma de pagamento 90, sem pagamento)"},{"valor":"5","significado":"Nota de crédito (previsto no leiaute; a engineAPI não cobre este caso de uso)"},{"valor":"6","significado":"Nota de débito (previsto no leiaute; a engineAPI não cobre este caso de uso)"}],"condicao":"Ausente = 1 (normal). A engineAPI deriva desta lista a validação do contrato e recusa valores fora de 1 a 6 antes da numeração. As finalidades 2, 3 e 4 exigem o grupo de documento referenciado (campo referenciadas): sem ele a engineAPI recusa com 422 FINALIDADE_SEM_NFREF ANTES de numerar. É regra de validação de negócio da SEFAZ (tabela cStat), não constraint do XSD: sem a guarda, a SEFAZ rejeitaria a nota DEPOIS de consumir o número, com cStat 254 na finalidade 2 (complementar) e cStat 321 na finalidade 4 (devolução); a finalidade 3 (ajuste) não tem cStat dedicado confirmado. As finalidades 3 e 4 exigem ainda pagamentos com forma 90 (sem pagamento), regra YA02-04 do MOC.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/finNFe (TFinNFe)"},"uniqueKey":"finNFe","typeLabel":"integer"},"referenciadas":{"description":"Documentos fiscais referenciados (grupo NFref do leiaute, máximo 500). Obrigatório em finNFe 2 (complementar), 3 (ajuste) e 4 (devolução): é o que liga a nota nova à original. Em finNFe 2 vale exatamente um","maxItems":500,"type":"array","items":{"type":"object","properties":{"chaveAcesso":{"type":"string","pattern":"^\\d{44}$","description":"Chave de acesso do documento referenciado (44 dígitos): NF-e (modelo 55), NFC-e (65) ou CF-e SAT (59). Vira a tag refNFe do documento","x-leiaute":{"tag":"refNFe","grupo":"ide: Identificação da NF-e","tamanho":"44","obrigatoriedadeLeiaute":"C","condicao":"Chave de acesso da NF-e ou NFC-e referenciada, 44 dígitos. O leiaute prevê o grupo como uma escolha entre seis variantes e a engineAPI escreve a primeira delas (refNFe, entre documentos eletrônicos): as variantes de nota de papel, produtor rural, CT-e, cupom de ECF e chave com código numérico zerado ainda não são suportadas. A chave é conferida antes da numeração: dígito verificador pelo módulo 11, código de UF na tabela do IBGE e modelo 55 ou 65.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/NFref/refNFe (TChNFe)"},"isRequired":true,"uniqueKey":"referenciadas.items.[INDEX].chaveAcesso","typeLabel":"string"}},"required":["chaveAcesso"],"additionalProperties":false,"uniqueKey":"referenciadas.items.[INDEX]","typeLabel":"object"},"x-leiaute":{"tag":"NFref","grupo":"ide: Identificação da NF-e","obrigatoriedadeLeiaute":"C","condicao":"Opcional no XSD (minOccurs 0), mas obrigatório por regra de negócio da SEFAZ nas finalidades 2 (complementar), 3 (ajuste) e 4 (devolução). Uma entrada do array vira um subgrupo NFref do leiaute, até 999. Cada chave entra uma única vez.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/ide/NFref (minOccurs=\"0\" maxOccurs=\"999\")","naoMapeado":"Grupo, não campo: NFref é o contêiner de um documento referenciado."},"uniqueKey":"referenciadas","typeLabel":"object[]"},"procRef":{"description":"Processos ou atos concessórios referenciados (grupo procRef das informações adicionais do leiaute, máximo 100). É onde se declara o regime especial, o termo de acordo ou o convênio que ampara o benefício fiscal informado nos itens","maxItems":100,"type":"array","items":{"type":"object","properties":{"nProc":{"type":"string","minLength":1,"maxLength":60,"description":"Identificador do processo ou ato concessório","x-leiaute":{"tag":"nProc","grupo":"infAdic: Informações Adicionais","tamanho":"1-60","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório dentro do grupo: identificador do processo ou do ato concessório.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/infAdic/procRef/nProc"},"isRequired":true,"uniqueKey":"procRef.items.[INDEX].nProc","typeLabel":"string"},"indProc":{"type":"string","enum":["0","1","2","3","4","9"],"description":"Origem do processo: \"0\"=SEFAZ, \"1\"=Justiça Federal, \"2\"=Justiça Estadual, \"3\"=Secex/RFB, \"4\"=CONFAZ, \"9\"=outros","x-leiaute":{"tag":"indProc","grupo":"infAdic: Informações Adicionais","tamanho":"1","obrigatoriedadeLeiaute":"C","valores":[{"valor":"0","significado":"SEFAZ"},{"valor":"1","significado":"Justiça Federal"},{"valor":"2","significado":"Justiça Estadual"},{"valor":"3","significado":"Secex ou Receita Federal"},{"valor":"4","significado":"CONFAZ"},{"valor":"9","significado":"Outros"}],"condicao":"Obrigatório dentro do grupo: origem do processo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/infAdic/procRef/indProc"},"isRequired":true,"uniqueKey":"procRef.items.[INDEX].indProc","typeLabel":"enum\u003cstring>"},"tpAto":{"description":"Tipo do ato concessório: \"08\"=termo de acordo, \"10\"=regime especial, \"12\"=autorização específica, \"14\"=ajuste SINIEF, \"15\"=convênio ICMS. O leiaute o prevê para processo de origem na SEFAZ (indProc \"0\"); com outra origem a emissão recusa com 422 ICMS_BENEFICIO_INVALIDO","type":"string","enum":["10","12","14","15","08"],"x-leiaute":{"tag":"tpAto","grupo":"infAdic: Informações Adicionais","tamanho":"2","obrigatoriedadeLeiaute":"C","valores":[{"valor":"08","significado":"Termo de acordo"},{"valor":"10","significado":"Regime especial"},{"valor":"12","significado":"Autorização específica"},{"valor":"14","significado":"Ajuste SINIEF"},{"valor":"15","significado":"Convênio ICMS"}],"condicao":"O leiaute prevê o tipo do ato concessório para processo de origem na SEFAZ (indProc \"0\"). Com outra origem o campo seria descartado, e a emissão recusa antes de consumir número fiscal.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/infAdic/procRef/tpAto (minOccurs=\"0\")"},"uniqueKey":"procRef.items.[INDEX].tpAto","typeLabel":"enum\u003cstring>"}},"required":["nProc","indProc"],"additionalProperties":false,"uniqueKey":"procRef.items.[INDEX]","typeLabel":"object"},"x-leiaute":{"tag":"procRef","grupo":"infAdic: Informações Adicionais","obrigatoriedadeLeiaute":"OC","condicao":"Processos ou atos concessórios referenciados, até 100 no leiaute. É onde se declara o regime especial, o termo de acordo ou o convênio que ampara o benefício fiscal informado nos itens. Uma entrada do array vira um grupo procRef do documento.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/infAdic/procRef (minOccurs=\"0\" maxOccurs=\"100\")"},"uniqueKey":"procRef","typeLabel":"object[]"},"transporte":{"description":"Dados de transporte. Se enviado, modFrete é obrigatório","type":"object","properties":{"modFrete":{"oneOf":[{"type":"number","description":"Modalidade do frete: 0=por conta do remetente/emitente (CIF), 1=por conta do destinatário (FOB), 2=por conta de terceiros, 3=transporte próprio por conta do remetente, 4=transporte próprio por conta do destinatário, 9=sem ocorrência de transporte","const":0,"x-leiaute":{"tag":"modFrete","grupo":"X: Informações do Transporte","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Frete contratado por conta do remetente (CIF)"},{"valor":"1","significado":"Frete contratado por conta do destinatário (FOB)"},{"valor":"2","significado":"Frete contratado por conta de terceiros"},{"valor":"3","significado":"Transporte próprio por conta do remetente"},{"valor":"4","significado":"Transporte próprio por conta do destinatário"},{"valor":"9","significado":"Sem ocorrência de transporte"}],"condicao":"Sem o grupo transporte no payload, a engineAPI escreve 9.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/modFrete"},"isRequired":true,"uniqueKey":"transporte.modFrete.oneOf.0","typeLabel":"number"},{"type":"number","description":"Modalidade do frete: 0=por conta do remetente/emitente (CIF), 1=por conta do destinatário (FOB), 2=por conta de terceiros, 3=transporte próprio por conta do remetente, 4=transporte próprio por conta do destinatário, 9=sem ocorrência de transporte","const":1,"x-leiaute":{"tag":"modFrete","grupo":"X: Informações do Transporte","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Frete contratado por conta do remetente (CIF)"},{"valor":"1","significado":"Frete contratado por conta do destinatário (FOB)"},{"valor":"2","significado":"Frete contratado por conta de terceiros"},{"valor":"3","significado":"Transporte próprio por conta do remetente"},{"valor":"4","significado":"Transporte próprio por conta do destinatário"},{"valor":"9","significado":"Sem ocorrência de transporte"}],"condicao":"Sem o grupo transporte no payload, a engineAPI escreve 9.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/modFrete"},"isRequired":true,"uniqueKey":"transporte.modFrete.oneOf.1","typeLabel":"number"},{"type":"number","description":"Modalidade do frete: 0=por conta do remetente/emitente (CIF), 1=por conta do destinatário (FOB), 2=por conta de terceiros, 3=transporte próprio por conta do remetente, 4=transporte próprio por conta do destinatário, 9=sem ocorrência de transporte","const":2,"x-leiaute":{"tag":"modFrete","grupo":"X: Informações do Transporte","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Frete contratado por conta do remetente (CIF)"},{"valor":"1","significado":"Frete contratado por conta do destinatário (FOB)"},{"valor":"2","significado":"Frete contratado por conta de terceiros"},{"valor":"3","significado":"Transporte próprio por conta do remetente"},{"valor":"4","significado":"Transporte próprio por conta do destinatário"},{"valor":"9","significado":"Sem ocorrência de transporte"}],"condicao":"Sem o grupo transporte no payload, a engineAPI escreve 9.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/modFrete"},"isRequired":true,"uniqueKey":"transporte.modFrete.oneOf.2","typeLabel":"number"},{"type":"number","description":"Modalidade do frete: 0=por conta do remetente/emitente (CIF), 1=por conta do destinatário (FOB), 2=por conta de terceiros, 3=transporte próprio por conta do remetente, 4=transporte próprio por conta do destinatário, 9=sem ocorrência de transporte","const":3,"x-leiaute":{"tag":"modFrete","grupo":"X: Informações do Transporte","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Frete contratado por conta do remetente (CIF)"},{"valor":"1","significado":"Frete contratado por conta do destinatário (FOB)"},{"valor":"2","significado":"Frete contratado por conta de terceiros"},{"valor":"3","significado":"Transporte próprio por conta do remetente"},{"valor":"4","significado":"Transporte próprio por conta do destinatário"},{"valor":"9","significado":"Sem ocorrência de transporte"}],"condicao":"Sem o grupo transporte no payload, a engineAPI escreve 9.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/modFrete"},"isRequired":true,"uniqueKey":"transporte.modFrete.oneOf.3","typeLabel":"number"},{"type":"number","description":"Modalidade do frete: 0=por conta do remetente/emitente (CIF), 1=por conta do destinatário (FOB), 2=por conta de terceiros, 3=transporte próprio por conta do remetente, 4=transporte próprio por conta do destinatário, 9=sem ocorrência de transporte","const":4,"x-leiaute":{"tag":"modFrete","grupo":"X: Informações do Transporte","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Frete contratado por conta do remetente (CIF)"},{"valor":"1","significado":"Frete contratado por conta do destinatário (FOB)"},{"valor":"2","significado":"Frete contratado por conta de terceiros"},{"valor":"3","significado":"Transporte próprio por conta do remetente"},{"valor":"4","significado":"Transporte próprio por conta do destinatário"},{"valor":"9","significado":"Sem ocorrência de transporte"}],"condicao":"Sem o grupo transporte no payload, a engineAPI escreve 9.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/modFrete"},"isRequired":true,"uniqueKey":"transporte.modFrete.oneOf.4","typeLabel":"number"},{"type":"number","description":"Modalidade do frete: 0=por conta do remetente/emitente (CIF), 1=por conta do destinatário (FOB), 2=por conta de terceiros, 3=transporte próprio por conta do remetente, 4=transporte próprio por conta do destinatário, 9=sem ocorrência de transporte","const":9,"x-leiaute":{"tag":"modFrete","grupo":"X: Informações do Transporte","tamanho":"1","obrigatoriedadeLeiaute":"O","valores":[{"valor":"0","significado":"Frete contratado por conta do remetente (CIF)"},{"valor":"1","significado":"Frete contratado por conta do destinatário (FOB)"},{"valor":"2","significado":"Frete contratado por conta de terceiros"},{"valor":"3","significado":"Transporte próprio por conta do remetente"},{"valor":"4","significado":"Transporte próprio por conta do destinatário"},{"valor":"9","significado":"Sem ocorrência de transporte"}],"condicao":"Sem o grupo transporte no payload, a engineAPI escreve 9.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/modFrete"},"isRequired":true,"uniqueKey":"transporte.modFrete.oneOf.5","typeLabel":"number"}],"isRequired":true,"uniqueKey":"transporte.modFrete","typeLabel":"number"},"transportadora":{"type":"object","properties":{"cnpjCpf":{"description":"CNPJ ou CPF da transportadora","type":"string","x-leiaute":{"tag":"CNPJ","tagAlternativa":"CPF","grupo":"X: Informações do Transporte","tamanho":"14 (CNPJ) ou 11 (CPF)","obrigatoriedadeLeiaute":"C","condicao":"Escolha exclusiva no leiaute, como no destinatário: CNPJ para pessoa jurídica, CPF para pessoa física. Obrigatório sempre que o subgrupo do transportador é emitido (é o subgrupo inteiro que é opcional, não o documento dentro dele).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta/CNPJ (TCnpj) e /CPF (TCpf)"},"uniqueKey":"transporte.transportadora.cnpjCpf","typeLabel":"string"},"nome":{"description":"Razão social ou nome da transportadora","type":"string","x-leiaute":{"tag":"xNome","grupo":"X: Informações do Transporte","tamanho":"2-60","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta/xNome"},"uniqueKey":"transporte.transportadora.nome","typeLabel":"string"},"ie":{"description":"Inscrição Estadual da transportadora","type":"string","x-leiaute":{"tag":"IE","grupo":"X: Informações do Transporte","tamanho":"2-14 (ou o literal ISENTO)","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta/IE (TIeDest)"},"uniqueKey":"transporte.transportadora.ie","typeLabel":"string"},"endereco":{"description":"Endereço da transportadora","type":"string","x-leiaute":{"tag":"xEnder","grupo":"X: Informações do Transporte","tamanho":"1-60","obrigatoriedadeLeiaute":"OC","condicao":"Endereço COMPLETO do transportador numa linha só (o leiaute não fatia logradouro, número e bairro aqui, ao contrário do endereço do destinatário).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta/xEnder"},"uniqueKey":"transporte.transportadora.endereco","typeLabel":"string"},"municipio":{"description":"Município da transportadora","type":"string","x-leiaute":{"tag":"xMun","grupo":"X: Informações do Transporte","tamanho":"1-60","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta/xMun"},"uniqueKey":"transporte.transportadora.municipio","typeLabel":"string"},"uf":{"description":"UF da transportadora","type":"string","x-leiaute":{"tag":"UF","grupo":"X: Informações do Transporte","tamanho":"2","obrigatoriedadeLeiaute":"OC","valores":[{"valor":"AC","significado":"Unidade federativa AC"},{"valor":"AL","significado":"Unidade federativa AL"},{"valor":"AM","significado":"Unidade federativa AM"},{"valor":"AP","significado":"Unidade federativa AP"},{"valor":"BA","significado":"Unidade federativa BA"},{"valor":"CE","significado":"Unidade federativa CE"},{"valor":"DF","significado":"Unidade federativa DF"},{"valor":"ES","significado":"Unidade federativa ES"},{"valor":"GO","significado":"Unidade federativa GO"},{"valor":"MA","significado":"Unidade federativa MA"},{"valor":"MG","significado":"Unidade federativa MG"},{"valor":"MS","significado":"Unidade federativa MS"},{"valor":"MT","significado":"Unidade federativa MT"},{"valor":"PA","significado":"Unidade federativa PA"},{"valor":"PB","significado":"Unidade federativa PB"},{"valor":"PE","significado":"Unidade federativa PE"},{"valor":"PI","significado":"Unidade federativa PI"},{"valor":"PR","significado":"Unidade federativa PR"},{"valor":"RJ","significado":"Unidade federativa RJ"},{"valor":"RN","significado":"Unidade federativa RN"},{"valor":"RO","significado":"Unidade federativa RO"},{"valor":"RR","significado":"Unidade federativa RR"},{"valor":"RS","significado":"Unidade federativa RS"},{"valor":"SC","significado":"Unidade federativa SC"},{"valor":"SE","significado":"Unidade federativa SE"},{"valor":"SP","significado":"Unidade federativa SP"},{"valor":"TO","significado":"Unidade federativa TO"},{"valor":"EX","significado":"Exterior"}],"preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta/UF (TUf)"},"uniqueKey":"transporte.transportadora.uf","typeLabel":"string"}},"additionalProperties":false,"x-leiaute":{"tag":"transporta","grupo":"X: Informações do Transporte","obrigatoriedadeLeiaute":"OC","condicao":"Subgrupo do transportador. Operação com CFOP de combustível que a Tabela CFOP marca com indComb 2 exige a identificação do transportador (cStat 362); a engineAPI não recusa por isso, então a regra fica com o integrador.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/transporta","naoMapeado":"Grupo, não campo: transporta é o contêiner dos dados do transportador."},"uniqueKey":"transporte.transportadora","typeLabel":"object"},"volumes":{"type":"array","items":{"type":"object","properties":{"quantidade":{"description":"Quantidade de volumes transportados","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"x-leiaute":{"tag":"qVol","grupo":"X: Informações do Transporte","tamanho":"1-15","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/vol/qVol"},"uniqueKey":"transporte.volumes.items.[INDEX].quantidade","typeLabel":"integer"},"especie":{"description":"Espécie dos volumes (ex.: \"Caixa\", \"Pallet\")","type":"string","x-leiaute":{"tag":"esp","grupo":"X: Informações do Transporte","tamanho":"1-60","obrigatoriedadeLeiaute":"OC","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/vol/esp"},"uniqueKey":"transporte.volumes.items.[INDEX].especie","typeLabel":"string"},"pesoBruto":{"description":"Peso bruto total em kg, com até 12 dígitos inteiros e 3 casas decimais","type":"number","minimum":0,"x-leiaute":{"tag":"pesoB","grupo":"X: Informações do Transporte","tamanho":"12v3","obrigatoriedadeLeiaute":"OC","condicao":"Peso em quilogramas.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/vol/pesoB (TDec_1203)"},"uniqueKey":"transporte.volumes.items.[INDEX].pesoBruto","typeLabel":"number"},"pesoLiquido":{"description":"Peso líquido total em kg, com até 12 dígitos inteiros e 3 casas decimais","type":"number","minimum":0,"x-leiaute":{"tag":"pesoL","grupo":"X: Informações do Transporte","tamanho":"12v3","obrigatoriedadeLeiaute":"OC","condicao":"Peso em quilogramas.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/vol/pesoL (TDec_1203)"},"uniqueKey":"transporte.volumes.items.[INDEX].pesoLiquido","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"transporte.volumes.items.[INDEX]","typeLabel":"object"},"x-leiaute":{"tag":"vol","grupo":"X: Informações do Transporte","obrigatoriedadeLeiaute":"OC","condicao":"Uma entrada do array vira um subgrupo vol do leiaute. Volume sem nenhum campo preenchido não gera subgrupo.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp/vol","naoMapeado":"Grupo, não campo: vol é o contêiner de um volume transportado."},"uniqueKey":"transporte.volumes","typeLabel":"object[]"}},"required":["modFrete"],"additionalProperties":false,"x-leiaute":{"tag":"transp","grupo":"X: Informações do Transporte","obrigatoriedadeLeiaute":"O","condicao":"O grupo é SEMPRE emitido: sem transporte no payload, a engineAPI declara modalidade 9 (sem ocorrência de transporte) explicitamente, em vez de deixar o motor fiscal assumir o default 0 (frete por conta do emitente).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/transp","naoMapeado":"Grupo, não campo: transp é o contêiner da modalidade do frete, do transportador e dos volumes."},"uniqueKey":"transporte","typeLabel":"object"},"troco":{"description":"Valor do troco em R$, para venda com pagamento em dinheiro (máximo 2 casas decimais)","type":"number","minimum":0,"x-leiaute":{"tag":"vTroco","grupo":"pag: Informações de Pagamento","tamanho":"13v2","obrigatoriedadeLeiaute":"OC","condicao":"Só é escrito quando maior que zero. No documento a tag é irmã de detPag (pertence ao grupo de pagamento inteiro, não a uma forma). O pré-voo confere soma dos pagamentos menos troco contra o total.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/pag/vTroco (TDec_1302)"},"uniqueKey":"troco","typeLabel":"number"},"cobranca":{"description":"Cobrança a prazo: fatura (numero, valorOriginal, valorDesconto, valorLiquido) sozinha, ou fatura + duplicatas[] (numero, vencimento, valor) juntas. O XSD aceita duplicatas sem fatura (irmãos, minOccurs=0); a API recusa essa combinação antes de numerar, pelas regras nacionais Y01-20 e Y10-10 (422 COBRANCA_INVALIDA). Informativo/financeiro: NÃO altera vNF nem `pagamentos` (quem fecha o total transmitido continua sendo `pagamentos`)","type":"object","properties":{"fatura":{"description":"Dados da fatura (grupo fat). Se enviado, os 4 campos são obrigatórios","type":"object","properties":{"numero":{"type":"string","minLength":1,"maxLength":60,"description":"Número da fatura (nFat do leiaute), 1 a 60 caracteres","x-leiaute":{"tag":"nFat","grupo":"Y: Cobrança","tamanho":"1-60","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório quando a fatura é enviada (ver o grupo fat).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/fat/nFat"},"isRequired":true,"uniqueKey":"cobranca.fatura.numero","typeLabel":"string"},"valorOriginal":{"type":"number","minimum":0,"description":"Valor original da fatura em R$ (vOrig)","x-leiaute":{"tag":"vOrig","grupo":"Y: Cobrança","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório quando a fatura é enviada.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/fat/vOrig (TDec_1302)"},"isRequired":true,"uniqueKey":"cobranca.fatura.valorOriginal","typeLabel":"number"},"valorDesconto":{"type":"number","minimum":0,"description":"Valor do desconto da fatura em R$ (vDesc). Não pode ser maior que valorOriginal","x-leiaute":{"tag":"vDesc","grupo":"Y: Cobrança","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório quando a fatura é enviada. Não pode ser maior que o valor original (regra do grupo de cobrança).","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/fat/vDesc (TDec_1302)"},"isRequired":true,"uniqueKey":"cobranca.fatura.valorDesconto","typeLabel":"number"},"valorLiquido":{"type":"number","minimum":0,"description":"Valor líquido da fatura em R$ (vLiq). Precisa ser igual a valorOriginal − valorDesconto, e igual à soma de duplicatas[].valor quando houver duplicatas (regras do grupo Y do leiaute, MOC Anexo I)","x-leiaute":{"tag":"vLiq","grupo":"Y: Cobrança","tamanho":"13v2","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório quando a fatura é enviada. Precisa ser igual a valorOriginal menos valorDesconto e igual à soma das duplicatas, quando houver duplicatas.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/fat/vLiq (TDec_1302)"},"isRequired":true,"uniqueKey":"cobranca.fatura.valorLiquido","typeLabel":"number"}},"required":["numero","valorOriginal","valorDesconto","valorLiquido"],"additionalProperties":false,"x-leiaute":{"tag":"fat","grupo":"Y: Cobrança","obrigatoriedadeLeiaute":"OC","condicao":"Se a fatura for enviada, os quatro campos são obrigatórios: o motor fiscal gera as quatro tags sempre que o bloco existe, e uma fatura parcial produziria tag vazia que o leiaute rejeita.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/fat","naoMapeado":"Grupo, não campo: fat é o contêiner dos dados da fatura."},"uniqueKey":"cobranca.fatura","typeLabel":"object"},"duplicatas":{"description":"Duplicatas do parcelamento (grupo dup, até 120). No XSD é irmã de `fatura` (ambas minOccurs=0). Este campo é compartilhado entre NF-e e NFC-e (mesmo `CobrancaSchema`), e o desfecho difere por modelo: na NF-e, as regras nacionais Y01-20/Y10-10 do MOC exigem `fatura` junto, duplicatas sem fatura é recusada com 422 (COBRANCA_INVALIDA) antes de numerar (na emissão medida em GO o retorno observado foi 851); na NFC-e essa distinção não chega a rodar, qualquer cobranca com conteúdo, com ou sem fatura, é recusada antes com 422 COBRANCA_NAO_SUPORTADA_NFCE. numero é tudo-ou-nada: se UMA duplicata tem numero, todas precisam ter","maxItems":120,"type":"array","items":{"type":"object","properties":{"vencimento":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data de vencimento da duplicata, formato AAAA-MM-DD (dVenc do leiaute). Precisa ser >= à data de emissão e não-decrescente entre as parcelas (regras do grupo Y do leiaute, MOC Anexo I)","x-leiaute":{"tag":"dVenc","grupo":"Y: Cobrança","tamanho":"10 (AAAA-MM-DD)","obrigatoriedadeLeiaute":"C","condicao":"Obrigatório no contrato: o leiaute rejeita duplicata sem vencimento ou com vencimento anterior à data de emissão. As parcelas precisam estar em ordem não decrescente.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/dup/dVenc (TData)"},"isRequired":true,"uniqueKey":"cobranca.duplicatas.items.[INDEX].vencimento","typeLabel":"string"},"valor":{"type":"number","minimum":0.01,"description":"Valor da duplicata em R$ (vDup do leiaute)","x-leiaute":{"tag":"vDup","grupo":"Y: Cobrança","tamanho":"13v2","obrigatoriedadeLeiaute":"O","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/dup/vDup (TDec_1302Opc)"},"isRequired":true,"uniqueKey":"cobranca.duplicatas.items.[INDEX].valor","typeLabel":"number"},"numero":{"description":"Número da duplicata (nDup do leiaute), 1 a 60 caracteres. Ausente = a engineAPI preenche sequencial (001, 002...): o documento sempre leva um nDup, nunca vazio","type":"string","minLength":1,"maxLength":60,"x-leiaute":{"tag":"nDup","grupo":"Y: Cobrança","tamanho":"1-60","obrigatoriedadeLeiaute":"OC","condicao":"Opcional no contrato, mas o documento SEMPRE leva um nDup: ausente, a engineAPI preenche sequencial (001, 002...). É tudo-ou-nada: se uma duplicata informa numero, todas precisam informar.","preenchimento":"automatico","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/dup/nDup"},"uniqueKey":"cobranca.duplicatas.items.[INDEX].numero","typeLabel":"string"}},"required":["vencimento","valor"],"additionalProperties":false,"uniqueKey":"cobranca.duplicatas.items.[INDEX]","typeLabel":"object"},"x-leiaute":{"tag":"dup","grupo":"Y: Cobrança","obrigatoriedadeLeiaute":"OC","condicao":"Uma entrada do array vira um subgrupo dup do leiaute (até 120). Estruturalmente o XSD permite vir sem fatura, mas as regras nacionais Y01-20/Y10-10 recusam essa combinação antes de numerar (422 COBRANCA_INVALIDA). Na emissão medida em GO o retorno observado foi 851.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr/dup (maxOccurs=\"120\")","naoMapeado":"Grupo, não campo: dup é o contêiner de uma parcela."},"uniqueKey":"cobranca.duplicatas","typeLabel":"object[]"}},"additionalProperties":false,"x-leiaute":{"tag":"cobr","grupo":"Y: Cobrança","obrigatoriedadeLeiaute":"OC","condicao":"Grupo informativo/financeiro: não altera o total do documento nem substitui pagamentos. fat e dup são IRMÃOS no XSD, mas as regras nacionais Y01-20/Y10-10 do MOC exigem fat quando há dup: duplicata sem fatura é recusada com 422 (COBRANCA_INVALIDA) antes de numerar. Na emissão medida em GO o retorno observado foi 851.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/cobr","naoMapeado":"Grupo, não campo: cobr é o contêiner da fatura e das duplicatas."},"uniqueKey":"cobranca","typeLabel":"object"},"informacoesComplementares":{"description":"Informações complementares de interesse do contribuinte, impressas no DANFE","type":"string","x-leiaute":{"tag":"infCpl","grupo":"infAdic: Informações Adicionais","tamanho":"1-5000","obrigatoriedadeLeiaute":"OC","condicao":"Texto livre de interesse do contribuinte, IMPRESSO no documento auxiliar. Ausente, a engineAPI escreve o texto padrão \"Nota Fiscal emitida via NFe Engine\", que sai impresso na nota; informe o campo para substituí-lo. Observação ESTRUTURADA (blocos nomeados obsCont) ainda não é suportada.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/infAdic/infCpl"},"uniqueKey":"informacoesComplementares","typeLabel":"string"},"informacoesFisco":{"description":"Informações adicionais de interesse do fisco","type":"string","maxLength":2000,"x-leiaute":{"tag":"infAdFisco","grupo":"infAdic: Informações Adicionais","tamanho":"1-2000","obrigatoriedadeLeiaute":"OC","condicao":"Texto livre de interesse do fisco. Observação ESTRUTURADA (blocos nomeados obsFisco) ainda não é suportada.","preenchimento":"integrador","fonte":"leiauteNFe_v4.00.xsd (PL_009p_NT2024_003_v103): TNFe/infNFe/infAdic/infAdFisco"},"uniqueKey":"informacoesFisco","typeLabel":"string"},"resolverTributacao":{"description":"Ativa a emissão assistida (Cérebro Fiscal): resolve CSOSN e o grupo IBS/CBS de itens sem tributação manual. Requer plano com fiscalBrain + Issuer.fiscalBrainEnabled","type":"boolean","x-leiaute":{"tag":null,"grupo":"engineAPI: plataforma","obrigatoriedadeLeiaute":"N","preenchimento":"integrador","fonte":"contrato da engineAPI (Cérebro Fiscal)","naoMapeado":"Chave de comportamento, não campo fiscal: liga a emissão assistida, em que a engineAPI resolve CSOSN e o grupo IBS/CBS dos itens sem tributação manual. Não vira tag nenhuma no documento."},"uniqueKey":"resolverTributacao","typeLabel":"boolean"}},"required":["destinatario","items","pagamentos"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"destinatario":{"cnpjCpf":"\u003cstring>","nome":"\u003cstring>","endereco":{"logradouro":"\u003cstring>","numero":"\u003cstring>","bairro":"\u003cstring>","codigoMunicipio":"\u003cstring>","municipio":"\u003cstring>","uf":"\u003cstring>","complemento":"\u003cstring>","cep":"\u003cstring>"},"ie":"\u003cstring>","indicadorIE":0,"email":"\u003cstring>"},"items":[{"codigo":"\u003cstring>","descricao":"\u003cstring>","ncm":"\u003cstring>","cfop":"\u003cstring>","unidade":"\u003cstring>","quantidade":1.0001,"valorUnitario":1.01,"ean":"\u003cstring>","cest":"\u003cstring>","cBenef":"\u003cstring>","valorTotal":123,"desconto":1,"valorFrete":1,"valorSeguro":1,"outrasDespesas":1,"indTot":0,"unidadeTributavel":"\u003cstring>","quantidadeTributavel":1.0001,"valorUnitarioTributavel":123,"icms":{"origem":4,"cst":"\u003cstring>","csosn":"\u003cstring>","aliquota":123,"baseCalculo":123,"valor":123,"baseCalculoST":123,"aliquotaST":123,"valorST":123,"pRedBC":1,"vBC":1,"pICMS":1,"vICMS":1,"vBCFCP":1,"pFCP":1,"vFCP":1,"pMVAST":1,"pRedBCST":1,"vBCST":1,"pICMSST":1,"vICMSST":1,"vBCFCPST":1,"pFCPST":1,"vFCPST":1,"pCredSN":1,"vCredICMSSN":1,"vBCSTRet":1,"pST":1,"vICMSSubstituto":1,"vICMSSTRet":1,"vBCFCPSTRet":1,"pFCPSTRet":1,"vFCPSTRet":1,"pRedBCEfet":1,"vBCEfet":1,"pICMSEfet":1,"vICMSEfet":1,"qBCMono":123,"adRemICMS":123,"vICMSMono":123,"qBCMonoRet":123,"adRemICMSRet":123,"vICMSMonoRet":123,"cBenefRBC":"\u003cstring>","vICMSDeson":1,"motDesICMS":"\u003cstring>","vICMSOp":1,"pDif":1,"vICMSDif":1,"pFCPDif":1,"vFCPDif":1,"vFCPEfet":1},"pis":{"cst":"\u003cstring>","baseCalculo":123,"aliquota":123,"quantidadeVendida":123,"valorAliquotaUnidade":123,"valor":123},"cofins":{"cst":"\u003cstring>","baseCalculo":123,"aliquota":123,"quantidadeVendida":123,"valorAliquotaUnidade":123,"valor":123},"ipi":{"cst":"\u003cstring>","baseCalculo":123,"aliquota":123,"quantidadeUnidadeTributavel":123,"valorUnidadeTributavel":123,"valor":123,"cEnq":"\u003cstring>"},"ibsCbs":{"ibsUf":{"p":1,"pNominal":1,"pRedAliq":50,"v":1},"ibsMun":{"p":1,"pNominal":1,"pRedAliq":50,"v":1},"cbs":{"p":1,"pNominal":1,"pRedAliq":50,"v":1},"cst":"\u003cstring>","cClassTrib":"\u003cstring>","vBC":1,"vIbs":1},"gCred":[{"cCredPresumido":"\u003cstring>","pCredPresumido":1,"vCredPresumido":1}]}],"pagamentos":[{"valor":1,"indicador":0}],"issuerId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","naturezaOperacao":"\u003cstring>","serie":0,"numero":0,"tpNF":0,"idDest":1,"indFinal":0,"indPres":0,"finNFe":3,"referenciadas":[{"chaveAcesso":"\u003cstring>"}],"procRef":[{"nProc":"\u003cstring>"}],"troco":1,"cobranca":{"duplicatas":[{"vencimento":"\u003cstring>","valor":1.01,"numero":"\u003cstring>"}]},"informacoesComplementares":"\u003cstring>","informacoesFisco":"\u003cstring>","resolverTributacao":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7f8138bc-084d-4080-9a02-f3ecf4d68695":{"description":"NF-e autorizada pela SEFAZ","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0888e0d3-7e37-4e56-861c-bea6c192bc21":{"description":"Payload inválido (validação nossa) ou rejeição da SEFAZ (`error.erros[]`)","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"409eea0a-6f03-413b-b88d-1ba79161d29e":{"description":"Emissão assistida (`resolverTributacao: true`) sem fonte para resolver um campo obrigatório, ou cadastro/certificado do emissor incompleto","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"1b6ff726-d7bf-49df-afe9-7a568f1cd3d8":{"API-Key":{"type":"apiKey","in":"header","name":"x-api-key","description":"API Key do Partner (formato: ek_live_UUID)","scopes":[],"schemeName":"API-Key"}},"697330c3-7416-4fb3-9df5-6ddae132f63e":{"JWT-auth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Token JWT obtido via /v1/auth/login","scopes":[],"schemeName":"JWT-auth"}}},"servers":{"d8878a6c-d70f-4081-90fd-dba8eecd399b":{"url":"https://api.engineapi.com.br","description":"Produção"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API Key do Partner (formato: ek_live_UUID)","scopes":[],"schemeName":"API-Key"},"schema":{"title":"x-api-key","type":"string","description":"API Key do Partner (formato: ek_live_UUID)","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"API-Key","name":"x-api-key"}],"title":"API-Key"},{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Token JWT obtido via /v1/auth/login","scopes":[],"schemeName":"JWT-auth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Token JWT obtido via /v1/auth/login","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"JWT-auth","name":"Authorization"}],"title":"JWT-auth"}]},"originalFileLocation":"openapi.json"},"subdomain":"3xtec","siteName":"EngineAPI","title":"Criar NF-e - EngineAPI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T19:08:16.150Z","originalFileLocation":"api-reference/nfe/criar-nf-e.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use POST /v1/nfe/batch (assíncrono, consultado depois em GET /v1/nfe/queue). Rejeição da SEFAZ volta como 400 com error.erros[] (código e descrição do motivo, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (validação nossa, a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.\">\u003cmeta data-mint-head name=\"application-name\" content=\"EngineAPI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar NF-e - EngineAPI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use POST /v1/nfe/batch (assíncrono, consultado depois em GET /v1/nfe/queue). Rejeição da SEFAZ volta como 400 com error.erros[] (código e descrição do motivo, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (validação nossa, a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"EngineAPI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://3xtec.mintlify.site/_mintlify/api/og/v2?division=NFe\u0026amp;title=Criar+NF-e\u0026amp;description=Emite+uma+NF-e+%28modelo+55%29+de+forma+s%C3%ADncrona%3A+a+chamada+s%C3%B3+retorna+depois+da+resposta+da+SEFAZ%2C+com+o+desfecho+real+no+%60status%60+do+envelope+%28%60AUTHORIZED%60+ou+%60RE\u0026amp;theme=afc36279d6b62627aee2125d\u0026amp;signature=d8c12675bb1ceae7defe238df643f8651867a807c98efd9186a419572b819db7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Criar NF-e - EngineAPI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use POST /v1/nfe/batch (assíncrono, consultado depois em GET /v1/nfe/queue). Rejeição da SEFAZ volta como 400 com error.erros[] (código e descrição do motivo, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (validação nossa, a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://3xtec.mintlify.site/_mintlify/api/og/v2?division=NFe\u0026amp;title=Criar+NF-e\u0026amp;description=Emite+uma+NF-e+%28modelo+55%29+de+forma+s%C3%ADncrona%3A+a+chamada+s%C3%B3+retorna+depois+da+resposta+da+SEFAZ%2C+com+o+desfecho+real+no+%60status%60+do+envelope+%28%60AUTHORIZED%60+ou+%60RE\u0026amp;theme=afc36279d6b62627aee2125d\u0026amp;signature=d8c12675bb1ceae7defe238df643f8651867a807c98efd9186a419572b819db7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/3xtec/e0fLCDQyVL4lj2rl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"EngineAPI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E56B1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/nfe/criar-nf-e.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.engineapi.com.br/#organization\",\"name\":\"EngineAPI\",\"url\":\"https://docs.engineapi.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/3xtec/upxot-gn5enp24zf/logo/light.svg?fit=max\u0026auto=format\u0026n=upxot-gn5enp24zf\u0026q=85\u0026s=63aef46d17335e80239cdc40c74322e9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.engineapi.com.br#website\",\"name\":\"EngineAPI\",\"url\":\"https://docs.engineapi.com.br\",\"publisher\":{\"@id\":\"https://docs.engineapi.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e#webpage\",\"url\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e\",\"name\":\"Criar NF-e\",\"description\":\"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use POST /v1/nfe/batch (assíncrono, consultado depois em GET /v1/nfe/queue). Rejeição da SEFAZ volta como 400 com error.erros[] (código e descrição do motivo, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (validação nossa, a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.\",\"dateModified\":\"2026-11-12T19:08:16.150Z\",\"isPartOf\":{\"@id\":\"https://docs.engineapi.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.engineapi.com.br/api-reference/sa%C3%BAde/raiz-da-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"NFe\",\"item\":\"https://docs.engineapi.com.br/api-reference/nfe/verificar-status-do-servi%C3%A7o-de-emiss%C3%A3o-nf-e\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Criar NF-e\",\"item\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e#apireference\",\"headline\":\"Criar NF-e\",\"name\":\"Criar NF-e\",\"description\":\"Emite uma NF-e (modelo 55) de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED, nunca um estado intermediário). Para emitir muitas notas de uma vez sem manter a conexão aberta, use POST /v1/nfe/batch (assíncrono, consultado depois em GET /v1/nfe/queue). Rejeição da SEFAZ volta como 400 com error.erros[] (código e descrição do motivo, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (validação nossa, a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.\",\"url\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e\",\"mainEntityOfPage\":{\"@id\":\"https://docs.engineapi.com.br/api-reference/nfe/criar-nf-e#webpage\"},\"dateModified\":\"2026-11-12T19:08:16.150Z\",\"publisher\":{\"@id\":\"https://docs.engineapi.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.engineapi.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"EngineAPI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"EngineAPI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/nfe/criar-nf-e.md","siteName":"EngineAPI","nav":{"global":null,"tabs":[{"tab":"Documentação","icon":"book-open","pages":[{"title":"Documentação","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Referência","icon":"list","pages":[{"title":"Referência da API","href":"/api-reference/overview"}]},{"group":"Endpoints","icon":"plug","pages":[{"group":"Saúde","pages":[{"title":"Raiz da API","deprecated":null,"version":null,"openapi":"/openapi.json get /v1","href":"/api-reference/saúde/raiz-da-api"},{"title":"Verificar liveness do processo","deprecated":null,"version":null,"openapi":"/openapi.json get /health/live","href":"/api-reference/saúde/verificar-liveness-do-processo"},{"title":"Sanidade de auth (API key / JWT): read-only","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/health/auth","href":"/api-reference/saúde/sanidade-de-auth-api-key-jwt:-read-only"},{"title":"Verificar readiness da aplicação","deprecated":null,"version":null,"openapi":"/openapi.json get /health","href":"/api-reference/saúde/verificar-readiness-da-aplicação"},{"title":"Consultar versão em execução","deprecated":null,"version":null,"openapi":"/openapi.json get /version","href":"/api-reference/saúde/consultar-versão-em-execução"}]},{"group":"Autenticação","pages":[{"title":"Autenticar usuário","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/login","href":"/api-reference/autenticação/autenticar-usuário"},{"title":"Concluir login com o segundo fator","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/2fa/verify","href":"/api-reference/autenticação/concluir-login-com-o-segundo-fator"},{"title":"Iniciar enrolamento do 2FA","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/2fa/setup","href":"/api-reference/autenticação/iniciar-enrolamento-do-2fa"},{"title":"Confirmar e ativar o 2FA","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/2fa/enable","href":"/api-reference/autenticação/confirmar-e-ativar-o-2fa"},{"title":"Desativar o 2FA","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/2fa/disable","href":"/api-reference/autenticação/desativar-o-2fa"},{"title":"Estado do 2FA da conta autenticada","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/auth/2fa/status","href":"/api-reference/autenticação/estado-do-2fa-da-conta-autenticada"},{"title":"Renovar a sessão","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/refresh","href":"/api-reference/autenticação/renovar-a-sessão"},{"title":"Encerrar a sessão","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/logout","href":"/api-reference/autenticação/encerrar-a-sessão"},{"title":"Login via Google OAuth","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/google","href":"/api-reference/autenticação/login-via-google-oauth"},{"title":"Alterar senha","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/change-password","href":"/api-reference/autenticação/alterar-senha"},{"title":"Registrar novo parceiro (SUPERADMIN)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/register-partner","href":"/api-reference/autenticação/registrar-novo-parceiro-superadmin"},{"title":"Cadastro pelo site cria a conta na hora (JOT-3540)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/register","href":"/api-reference/autenticação/cadastro-pelo-site-cria-a-conta-na-hora-jot-3540"},{"title":"Solicitar recuperação de senha","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/forgot-password","href":"/api-reference/autenticação/solicitar-recuperação-de-senha"},{"title":"Redefinir senha com token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/reset-password","href":"/api-reference/autenticação/redefinir-senha-com-token"},{"title":"Verificar e-mail com token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/verify-email","href":"/api-reference/autenticação/verificar-e-mail-com-token"},{"title":"Reenviar e-mail de verificação","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/resend-verification","href":"/api-reference/autenticação/reenviar-e-mail-de-verificação"},{"title":"Status de verificação de e-mail","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/auth/verification-status","href":"/api-reference/autenticação/status-de-verificação-de-e-mail"},{"title":"Gerar/regenerar API Key de PRODUÇÃO (ek_live_)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/api-keys/regenerate","href":"/api-reference/autenticação/gerarregenerar-api-key-de-produção-ek_live_"},{"title":"Gerar/regenerar API Key de TESTE (ek_test_)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/api-keys/test/regenerate","href":"/api-reference/autenticação/gerarregenerar-api-key-de-teste-ek_test_"},{"title":"Informações da API Key","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/auth/api-keys/info","href":"/api-reference/autenticação/informações-da-api-key"},{"title":"Pedir novo convite de dono","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auth/invite/resend","href":"/api-reference/autenticação/pedir-novo-convite-de-dono"}]},{"group":"Empresas","pages":[{"title":"Listar empresas emissoras","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies","href":"/api-reference/empresas/listar-empresas-emissoras"},{"title":"Cadastrar empresa emissora","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/companies","href":"/api-reference/empresas/cadastrar-empresa-emissora"},{"title":"Consultar CNPJ antes de cadastrar","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/consult/{cnpj}","href":"/api-reference/empresas/consultar-cnpj-antes-de-cadastrar"},{"title":"Solicitar transferência de emissor","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/companies/transfer-request","href":"/api-reference/empresas/solicitar-transferência-de-emissor"},{"title":"Cancelar solicitação de transferência","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/companies/transfer-request/{id}/cancel","href":"/api-reference/empresas/cancelar-solicitação-de-transferência"},{"title":"Buscar empresa por ID","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}","href":"/api-reference/empresas/buscar-empresa-por-id"},{"title":"Excluir empresa emissora","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/companies/{id}","href":"/api-reference/empresas/excluir-empresa-emissora"},{"title":"Atualizar empresa emissora","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/companies/{id}","href":"/api-reference/empresas/atualizar-empresa-emissora"},{"title":"Promover o próprio emissor para homologação SEFAZ","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/companies/{id}/promover-homologacao","href":"/api-reference/empresas/promover-o-próprio-emissor-para-homologação-sefaz"},{"title":"Enviar certificado digital do emissor","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/companies/{id}/certificate","href":"/api-reference/empresas/enviar-certificado-digital-do-emissor"},{"title":"Trocar ambiente fiscal do emissor (Produção/Homologação)","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/companies/{id}/ambiente","href":"/api-reference/empresas/trocar-ambiente-fiscal-do-emissor-produçãohomologação"}]},{"group":"Consultas","pages":[{"title":"Consultar CNPJ","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/queries/cnpj/{cnpj}","href":"/api-reference/consultas/consultar-cnpj"},{"title":"Invalidar cache de CNPJ","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/queries/cnpj/{cnpj}/cache","href":"/api-reference/consultas/invalidar-cache-de-cnpj"},{"title":"Consultar CPF (LGPD)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/queries/cpf/{cpf}","href":"/api-reference/consultas/consultar-cpf-lgpd"},{"title":"Excluir dados de CPF (LGPD)","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/queries/cpf/{cpf}","href":"/api-reference/consultas/excluir-dados-de-cpf-lgpd"}]},{"group":"NFSe","pages":[{"title":"Cobertura da NFS-e por município","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/cobertura/{ibge}","href":"/api-reference/nfse/cobertura-da-nfs-e-por-município"},{"title":"Listar NFS-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse","href":"/api-reference/nfse/listar-nfs-e"},{"title":"Emitir NFS-e","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfse","href":"/api-reference/nfse/emitir-nfs-e"},{"title":"Exportar NFSe em CSV","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/export","href":"/api-reference/nfse/exportar-nfse-em-csv"},{"title":"Comprovante do cancelamento da NFS-e (PDF)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/cancelamento/{id}/pdf","href":"/api-reference/nfse/comprovante-do-cancelamento-da-nfs-e-pdf"},{"title":"Detalhes da NFS-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/{id}","href":"/api-reference/nfse/detalhes-da-nfs-e"},{"title":"Cancelar NFS-e","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfse/{id}/cancelar","href":"/api-reference/nfse/cancelar-nfs-e"},{"title":"Consultar NFS-e na SEFIN","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/{id}/consultar","href":"/api-reference/nfse/consultar-nfs-e-na-sefin"},{"title":"Download PDF","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/pdf/{id}","href":"/api-reference/nfse/download-pdf"},{"title":"Download DANFSe (alias)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/{id}/danfse","href":"/api-reference/nfse/download-danfse-alias"},{"title":"Download XML","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfse/xml/{id}","href":"/api-reference/nfse/download-xml"}]},{"group":"NFe","pages":[{"title":"Verificar status do serviço de emissão NF-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/status","href":"/api-reference/nfe/verificar-status-do-serviço-de-emissão-nf-e"},{"title":"Status SEFAZ por UF","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/sefaz-status/{uf}","href":"/api-reference/nfe/status-sefaz-por-uf"},{"title":"Status SEFAZ de todas as UFs","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/sefaz-status","href":"/api-reference/nfe/status-sefaz-de-todas-as-ufs"},{"title":"Listar NF-e","description":"Lista as NF-e do partner autenticado, paginada e filtrável por empresa emissora, status e período de emissão.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe","href":"/api-reference/nfe/listar-nf-e"},{"title":"Criar NF-e","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe","href":"/api-reference/nfe/criar-nf-e"},{"title":"Exportar NF-e em CSV","description":"Exporta as NF-e do partner (filtros de `companyId`/`status`/período) em CSV, até 10.000 registros por chamada. Requer sessão JWT do painel, não aceita `x-api-key`.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/export","href":"/api-reference/nfe/exportar-nf-e-em-csv"},{"title":"Listar fila de emissão em lote","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/queue","href":"/api-reference/nfe/listar-fila-de-emissão-em-lote"},{"title":"Buscar NF-e por ID","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/{id}","href":"/api-reference/nfe/buscar-nf-e-por-id"},{"title":"Excluir registro de NF-e","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/nfe/{id}","href":"/api-reference/nfe/excluir-registro-de-nf-e"},{"title":"Atualizar registro de NF-e","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/nfe/{id}","href":"/api-reference/nfe/atualizar-registro-de-nf-e"},{"title":"Inutilizar faixa de numeração de NF-e","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe/inutilizar","href":"/api-reference/nfe/inutilizar-faixa-de-numeração-de-nf-e"},{"title":"Cancelar NF-e","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe/{idOuChave}/cancelar","href":"/api-reference/nfe/cancelar-nf-e"},{"title":"Enfileirar notas para emissão em lote","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe/batch","href":"/api-reference/nfe/enfileirar-notas-para-emissão-em-lote"},{"title":"Download do DANFE (PDF)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/pdf/{accessKey}","href":"/api-reference/nfe/download-do-danfe-pdf"},{"title":"Download do XML da NF-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/xml/{chaveOuId}","href":"/api-reference/nfe/download-do-xml-da-nf-e"},{"title":"Download do XML da Carta de Correção","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/cce/{accessKey}/xml","href":"/api-reference/nfe/download-do-xml-da-carta-de-correção"},{"title":"Download do documento auxiliar da Carta de Correção","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/cce/{accessKey}/pdf","href":"/api-reference/nfe/download-do-documento-auxiliar-da-carta-de-correção"},{"title":"Comprovante do cancelamento da NF-e (PDF)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/cancelamento/{accessKey}/pdf","href":"/api-reference/nfe/comprovante-do-cancelamento-da-nf-e-pdf"},{"title":"Carta de Correção (CC-e) por chave de acesso (JWT ou x-api-key)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe/{accessKey}/carta-correcao","href":"/api-reference/nfe/carta-de-correção-cc-e-por-chave-de-acesso-jwt-ou-x-api-key"},{"title":"Cancelar NF-e pelo dashboard","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe/{id}/cancelar-dashboard","href":"/api-reference/nfe/cancelar-nf-e-pelo-dashboard"},{"title":"Enviar Carta de Correção (CC-e) via dashboard","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfe/{id}/cce","href":"/api-reference/nfe/enviar-carta-de-correção-cc-e-via-dashboard"},{"title":"Listar eventos fiscais da NF-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfe/{id}/eventos","href":"/api-reference/nfe/listar-eventos-fiscais-da-nf-e"}]},{"group":"Webhooks","pages":[{"title":"Obter configuração de webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/config","href":"/api-reference/webhooks/obter-configuração-de-webhooks"},{"title":"Atualizar configuração de webhooks","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhooks/config","href":"/api-reference/webhooks/atualizar-configuração-de-webhooks"},{"title":"Enviar webhook de teste","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/test","href":"/api-reference/webhooks/enviar-webhook-de-teste"},{"title":"Histórico de entregas","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/logs","href":"/api-reference/webhooks/histórico-de-entregas"},{"title":"Regenerar webhook secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/secret/regenerate","href":"/api-reference/webhooks/regenerar-webhook-secret"},{"title":"Listar Dead Letter Queue","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/dlq","href":"/api-reference/webhooks/listar-dead-letter-queue"},{"title":"Limpar DLQ","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/dlq","href":"/api-reference/webhooks/limpar-dlq"},{"title":"Reenviar webhook da DLQ","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/dlq/{deliveryId}/retry","href":"/api-reference/webhooks/reenviar-webhook-da-dlq"},{"title":"Reenviar TODOS da DLQ","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/dlq/retry-all","href":"/api-reference/webhooks/reenviar-todos-da-dlq"}]},{"group":"Cérebro Fiscal","pages":[{"title":"Resolver classificação + tributação de um produto (assistido)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/resolve","href":"/api-reference/cérebro-fiscal/resolver-classificação-+-tributação-de-um-produto-assistido"},{"title":"Resolver classificação + tributação de um serviço (NFS-e, assistido)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/resolve-servico","href":"/api-reference/cérebro-fiscal/resolver-classificação-+-tributação-de-um-serviço-nfs-e-assistido"},{"title":"Sugerir atividade de serviço padrão (LC116/cTribNac) a partir do CNAE (consultivo)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/resolve-servico-padrao","href":"/api-reference/cérebro-fiscal/sugerir-atividade-de-serviço-padrão-lc116ctribnac-a-partir-do-cnae-consultivo"},{"title":"Sugerir NCM a partir da descrição do produto (consultivo)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/resolve-ncm","href":"/api-reference/cérebro-fiscal/sugerir-ncm-a-partir-da-descrição-do-produto-consultivo"},{"title":"Confirmar a classificação de um produto (loop de validação)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/confirm","href":"/api-reference/cérebro-fiscal/confirmar-a-classificação-de-um-produto-loop-de-validação"},{"title":"Corrigir a classificação de um produto (loop de validação)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/correct","href":"/api-reference/cérebro-fiscal/corrigir-a-classificação-de-um-produto-loop-de-validação"},{"title":"Comerciante confirma o NCM ou o código de serviço incerto (degrau 3 da cascata)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/confirm-merchant","href":"/api-reference/cérebro-fiscal/comerciante-confirma-o-ncm-ou-o-código-de-serviço-incerto-degrau-3-da-cascata"},{"title":"Corrigir a classificação lembrada de um produto SEM código de barras","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/description-memory/correct","href":"/api-reference/cérebro-fiscal/corrigir-a-classificação-lembrada-de-um-produto-sem-código-de-barras"},{"title":"Revogar a classificação lembrada de um produto SEM código de barras","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/description-memory/revoke","href":"/api-reference/cérebro-fiscal/revogar-a-classificação-lembrada-de-um-produto-sem-código-de-barras"},{"title":"Comerciante responde a pergunta de fato da classe IBS/CBS","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/classe/confirm-merchant","href":"/api-reference/cérebro-fiscal/comerciante-responde-a-pergunta-de-fato-da-classe-ibscbs"},{"title":"Confirmar a classe IBS/CBS de um produto neste emissor","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classification/classe","href":"/api-reference/cérebro-fiscal/confirmar-a-classe-ibscbs-de-um-produto-neste-emissor"},{"title":"Listar as classes IBS/CBS vigentes de um NCM (consultivo)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classes-por-ncm","href":"/api-reference/cérebro-fiscal/listar-as-classes-ibscbs-vigentes-de-um-ncm-consultivo"},{"title":"Itens com classe IBS/CBS pendente neste emissor","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/fiscal/classification/pendentes","href":"/api-reference/cérebro-fiscal/itens-com-classe-ibscbs-pendente-neste-emissor"},{"title":"Listar ciclos de mudança de regra fiscal","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/fiscal/changelog","href":"/api-reference/cérebro-fiscal/listar-ciclos-de-mudança-de-regra-fiscal"},{"title":"Prontidão fiscal do motor (emissão assistida)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/fiscal/prontidao","href":"/api-reference/cérebro-fiscal/prontidão-fiscal-do-motor-emissão-assistida"},{"title":"Classificar a empresa em produto, serviço ou ambíguo pelos CNAEs (consultivo)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/fiscal/classificar-cnae","href":"/api-reference/cérebro-fiscal/classificar-a-empresa-em-produto-serviço-ou-ambíguo-pelos-cnaes-consultivo"}]},{"group":"NFCe","pages":[{"title":"Verificar status do serviço NFC-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce/status","href":"/api-reference/nfce/verificar-status-do-serviço-nfc-e"},{"title":"Listar NFC-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce","href":"/api-reference/nfce/listar-nfc-e"},{"title":"Emitir NFC-e (Modelo 65)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfce","href":"/api-reference/nfce/emitir-nfc-e-modelo-65"},{"title":"Download do DANFCE (PDF)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce/pdf/{accessKey}","href":"/api-reference/nfce/download-do-danfce-pdf"},{"title":"Comprovante do cancelamento da NFC-e (PDF)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce/cancelamento/{accessKey}/pdf","href":"/api-reference/nfce/comprovante-do-cancelamento-da-nfc-e-pdf"},{"title":"Download do XML da NFC-e","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce/xml/{accessKey}","href":"/api-reference/nfce/download-do-xml-da-nfc-e"},{"title":"Inutilizar faixa de numeração de NFC-e","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfce/inutilizar","href":"/api-reference/nfce/inutilizar-faixa-de-numeração-de-nfc-e"},{"title":"Cancelar NFC-e autorizada","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/nfce/{idOuChave}/cancelar","href":"/api-reference/nfce/cancelar-nfc-e-autorizada"},{"title":"Exportar NFC-e em CSV","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce/export","href":"/api-reference/nfce/exportar-nfc-e-em-csv"},{"title":"Buscar NFC-e por ID","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/nfce/{id}","href":"/api-reference/nfce/buscar-nfc-e-por-id"}]},{"group":"Cadastros","pages":[{"title":"Consultar créditos de cadastro","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cadastros/creditos","href":"/api-reference/cadastros/consultar-créditos-de-cadastro"},{"title":"Consultar cadastro por CNPJ","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cadastros/{cnpj}","href":"/api-reference/cadastros/consultar-cadastro-por-cnpj"}]},{"group":"Status","pages":[{"title":"Consultar status público por serviço","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/status","href":"/api-reference/status/consultar-status-público-por-serviço"},{"title":"Verificar saúde do servidor MCP","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/mcp/health","href":"/api-reference/status/verificar-saúde-do-servidor-mcp"}]}]},{"group":"Catálogo de campos","icon":"table-list","pages":[{"title":"Referência de campos: NFe","href":"/api-reference/campos-nfe"},{"title":"Referência de campos: NFCe","href":"/api-reference/campos-nfce"},{"title":"Referência de campos: NFSe","href":"/api-reference/campos-nfse"},{"title":"Referência de campos: Cérebro Fiscal (resolve-ncm)","href":"/api-reference/campos-fiscal-resolve-ncm"},{"title":"Referência de campos: Cérebro Fiscal (resolve-servico-padrao)","href":"/api-reference/campos-fiscal-resolve-servico-padrao"},{"title":"Referência de campos: Cérebro Fiscal (resolve, produto)","href":"/api-reference/campos-fiscal-resolve"},{"title":"Referência de campos: Cérebro Fiscal (resolve-servico)","href":"/api-reference/campos-fiscal-resolve-servico"}]}]},{"tab":"SDKs","icon":"cube","pages":[{"title":"SDKs","href":"/sdks/typescript"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Criar NF-e - EngineAPI","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}