# Novos campos do layout Nacional

Para emitir **NFS-e Nacional** de forma completa e aderente ao **padrão da Receita**, especialmente para empresas do **Regime Normal** e do **Simples Nacional (não-MEI)**, o payload precisa carregar informações fiscais que até então não eram exigidas nos layouts próprios dos webservices municipais. Os campos abaixo viabilizam:

* **Enquadramento tributário correto** (SN x Regime Normal) e regras de apuração;
* **Rastreabilidade fiscal** (referências/documentos que justificam abatimentos/observações);
* **Classificação de serviço padronizada** (NBS);
* **Tratamento de PIS/COFINS** (CST e retenção);
* **Reduções específicas de base** (benefício municipal, quando existir);
* **Totalização por esfera** (federal/estadual/municipal) no retorno.

***

### 📌Novos campos na raíz do payload

<pre class="language-json"><code class="lang-json"><strong>"regApTribSN": 1,
</strong>"docRef": "string",
"cPaisPrestacao": "string",
</code></pre>

### 📍Tabela de Referência – Novos campos na raíz do payload

<table><thead><tr><th width="152">Campo</th><th>Tipo</th><th>Tamanho</th><th>Obrigatório</th><th>Obs</th></tr></thead><tbody><tr><td><sub>regApTribSN</sub></td><td><sub>int</sub></td><td><sub>9</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>docRef</sub></td><td><sub>string</sub></td><td><sub>255</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>cPaisPrestacao</sub></td><td><sub>string</sub></td><td><sub>1</sub></td><td><sub>Não</sub></td><td><sub>Código do país onde ocorreu a prestação do serviço.</sub><br><sub>(Tabela de Países ISO)</sub></td></tr></tbody></table>

{% hint style="info" %}
O campo `cPaisPrestacao` será preenchido como Brasil, caso não preenchido
{% endhint %}

#### **Valores permitidos – `tpEnteGov`**

Regime de Apuração Tributária pelo Simples Nacional.

Opção para que o contribuinte optante pelo Simples Nacional ME/EPP (opSimpNac = 3) possa indicar, ao emitir o documento fiscal, em qual regime de apuração os tributos federais e municipal estão inseridos, caso tenha ultrapassado algum sublimite ou limite definido para o Simples Nacional.

1 – Regime de apuração dos tributos federais e municipal pelo SN;\
2 – Regime de apuração dos tributos federais pelo SN e o ISSQN pela NFS-e conforme respectiva legislação municipal do tributo;\
3 – Regime de apuração dos tributos federais e municipal pela NFS-e conforme respectivas legilações federal e municipal de cada tributo;

{% hint style="info" %}
Conforme mostrado no tópico de adaptações, este campo pode ser parametrizado no cadastro de empresa
{% endhint %}

### 📌Novos campos em `servico`

```json
{
  "servico": {
    "codigo": "string",
    "cNBS": "string", // Código NBS do serviço - Nomenclatura Brasileira de Serviços, Intangíveis e outras Operações que produzam Variações no Patrimônio
    "valor": 0,
    "deducoes": 0,
    "aliquotaServicos": 0,
    "CSTPisCofins": "string", // Código de Situação Tributária do PIS/COFINS (CST)
    "retPisCofins": 0, // Tipo de retenção ao do PIS/COFINS
    "aliquotaPIS": 0,
    "aliquotaCOFINS": 0,
    "aliquotaINSS": 0,
    "aliquotaIR": 0,
    "aliquotaCSLL": 0,
    "valorISS": 0,
    "vDedRed": { // Grupo de informações relativas ao valores para dedução/redução do valor da base de cálculo (valor do serviço)
      "pDR": 0.00,
      "pDR": 00.00
    },
    "outrasRetencoes": 0,
    "responsavelRetencao": "string"
  },
}
```

### 📍Tabela de Referência – Novos campos em `servico`

<table><thead><tr><th width="152">Campo</th><th width="128.79998779296875">Tipo</th><th width="127.4000244140625">Tamanho</th><th width="99.39996337890625">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><sub>cNBS</sub></td><td><sub>string</sub></td><td><sub>9</sub></td><td><sub>Não</sub></td><td><sub>Código NBS  (Nomenclatura Brasileira de Serviços, Intangíveis e outras Operações que produzam Variações no Patrimônio) correspondente ao serviço prestado</sub></td></tr><tr><td><sub>CSTPisCofins</sub></td><td><sub>string</sub></td><td><sub>2</sub></td><td><sub>Não</sub></td><td><sub>Código de Situação Tributária do PIS/COFINS (CST)</sub></td></tr><tr><td><sub>retPisCofins</sub></td><td><sub>int</sub></td><td><sub>1</sub></td><td><sub>Não</sub></td><td><sub>Tipo de retenção ao do PIS/COFINS</sub></td></tr><tr><td><sub>vDedRed</sub></td><td><sub>grupo</sub></td><td><sub>-</sub></td><td><sub>Não</sub></td><td><sub>Grupo de informações relativas ao valores para dedução/redução do valor da base de cálculo (valor do serviço)</sub></td></tr><tr><td><sub>pDR</sub></td><td><sub>decimal</sub></td><td><sub>1-3v2</sub></td><td><sub>Sim</sub></td><td><sub>Valor percentual padrão para dedução/redução do valor do serviço.</sub></td></tr><tr><td><sub>vDR</sub></td><td><sub>decimal</sub></td><td><sub>1-15v2</sub></td><td><sub>Sim</sub></td><td><sub>Valor monetário padrão para dedução/redução do valor do serviço.</sub></td></tr></tbody></table>

{% hint style="info" %}

### O campo `cNBS` passou a ser obrigatório na nova versão do layout da Reforma Tributária, portanto, será obrigatório a partir de janeiro

{% endhint %}

### 📌bm - Grupo de informações sobre o tipo do Benefício Municipal

```json
"bm":{
    "nBM": 0, 
    "vRedBCBM": 0.00, 
    "pRedBCBM": 0.00
}
```

### 📍Tabela de Referência – Novos grupo `bm`&#x20;

<table><thead><tr><th width="152">Campo</th><th>Tipo</th><th>Tamanho</th><th>Obrigatório</th><th>Obs</th></tr></thead><tbody><tr><td><sub>bm</sub></td><td><sub>grupo</sub></td><td><sub>-</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>nBM</sub></td><td><sub>int</sub></td><td><sub>14</sub></td><td><sub>Sim</sub></td><td></td></tr><tr><td><sub>vRedBCBM</sub></td><td><sub>decimal</sub></td><td><sub>1-15v2</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>pRedBCBM</sub></td><td><sub>decimal</sub></td><td><sub>1-3v2</sub></td><td><sub>Não</sub></td><td></td></tr></tbody></table>

### 📌totTrib - Grupo de informações para totais aproximados dos tributos relacionados ao serviço prestado

```json
"totTrib": {
    "indTotTrib": 0,
    "pTotTribSN": 0.00
    "vTotTrib": {
        "vTotTribFed": 0.00,
        "vTotTribEst": 0.00,
        "vTotTribMun": 0.00
    }
}
```

### 📍Tabela de Referência – Novos grupo `totTrib`&#x20;

<table><thead><tr><th width="152">Campo</th><th width="100.20001220703125">Tipo</th><th width="108.20001220703125">Tamanho</th><th width="117.79998779296875">Obrigatório</th><th>Obs</th></tr></thead><tbody><tr><td><sub>totTrib</sub></td><td><sub>grupo</sub></td><td><sub>-</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>indTotTrib</sub></td><td><sub>int</sub></td><td><sub>1</sub></td><td><sub>Não</sub></td><td><p><sub>Indicador de informação de valor total de tributos.</sub><br><sub>Se informado indica que o emitente opta por não informar nenhum valor estimado para os Tributos</sub><br><sub>(Decreto 8.264/2014).</sub></p><p><sub>0 - Não;</sub></p></td></tr><tr><td><sub>pTotTribSN</sub></td><td><sub>decimal</sub></td><td><sub>1-15v2</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>vTotTrib</sub></td><td><sub>grupo</sub></td><td><sub>-</sub></td><td><sub>Não</sub></td><td></td></tr><tr><td><sub>vTotTribFed</sub></td><td><sub>decimal</sub></td><td><sub>1-15v2</sub></td><td><sub>Sim</sub></td><td></td></tr><tr><td><sub>vTotTribEst</sub></td><td><sub>decimal</sub></td><td><sub>1-15v2</sub></td><td><sub>Sim</sub></td><td></td></tr><tr><td><sub>vTotTribMun</sub></td><td><sub>decimal</sub></td><td><sub>1-15v2</sub></td><td><sub>Sim</sub></td><td></td></tr></tbody></table>

{% hint style="info" %}

### Caso o grupo totTrib não seja enviado, a invoiSys preencherá o XML automaticamente com indTotTrib = 0 (Se informado indica que o emitente opta por não informar nenhum valor estimado para os Tributos)

{% endhint %}

### 📍Exemplo do `vItem` e `DFeReferenciado` em `det`

```csharp
{
"ambiente": 2,
"xml": "...
<ide>
...
 <det>
  <prod>
    ...
    <indBemMovelUsado>1</indBemMovelUsado> 
    ...
   </prod> 
     <imposto>
     ...
   <DFeReferenciado> <!-- Documento Fiscal Eletrônico Referenciado -->
      <chaveAcesso>00000000000000000000000000000000000000000000</chaveAcesso>
      <nItem>1</nItem>
   </DFeReferenciado>
 </det>
 ..."
}
```
