Notas de Alterações - Plugin Notacontrol RTC

crição das alerações

# plugin_notacontrol_rtc

## Versão

v1 - 29/04/2026

## Descrição

Plugin desenvolvido para envio de DPS no padrão **NFSe Nacional (layout 2.04)** utilizando o método `RecepcionarLoteDps`.

## Principais ajustes

* Implementado envio no formato **EnviarLoteDpsEnvio**
* Adequação ao novo **XSD nacional**
* Inclusão de **dupla assinatura digital**:

  * Assinatura da **DPS** (tag `infDPS`)
  * Assinatura do **LoteDps** (posicionada fora da tag `LoteDps`, conforme XSD)
* Correção de estrutura XML conforme exigência do provedor
* Ajuste de namespaces para `http://www.sped.fazenda.gov.br/nfse`

## Observações

* A tag `<Signature>` do lote deve ser posicionada como filha direta de `<EnviarLoteDpsEnvio>`
* A tag `<NumeroLote>` deve conter apenas valor numérico
* A tag `<DPS>` deve respeitar case sensitive (maiúsculo)
* Ambiente pode exigir liberação prévia para evitar erro 400

## Método utilizado

* `RecepcionarLoteDps`

---

# plugin_notacontrol_rtc

## Versão

v2 - 03/06/2026

## Descrição

Plugin desenvolvido para integração com a **NFSe Nacional** utilizando o layout DPS versão 1.01.

A partir desta versão foi adicionada compatibilidade com os ambientes de **Produção** e **Homologação**, realizando automaticamente as adequações exigidas pelo ambiente nacional.

## Principais ajustes

### Produção

* Utilização do método `RecepcionarLoteDps`
* Geração do XML no formato `EnviarLoteDpsEnvio`
* Utilização do código do município do prestador
* Utilização da série original do RPS

### Homologação

Devido às regras atuais do ambiente nacional de homologação, o plugin passa a utilizar parâmetros específicos para testes:

| Parâmetro                   | Valor                      |
| --------------------------- | -------------------------- |
| Método                      | RecepcionarLoteDpsSincrono |
| XML                         | EnviarLoteDpsSincronoEnvio |
| Código Município Emissão    | 5002704                    |
| Local Prestação             | 5002704                    |
| Série DPS                   | 8                          |
| Código Tributação Municipal | 7                          |

Além disso, o identificador da DPS (Id) é montado utilizando o município de homologação (5002704), conforme exigência do ambiente de testes.

## Assinatura Digital

O plugin mantém a assinatura digital dos documentos conforme layout nacional:

* Assinatura da DPS (`infDPS`)
* Assinatura do Lote DPS

## Conversões Implementadas

### Envio

ABRASF → DPS Nacional

* LinxEnviarLoteRps
* RecepcionarLoteDps
* RecepcionarLoteDpsSincrono

### Consulta de Lote

ABRASF → DPS Nacional

* ConsultarLoteRps
* ConsultarLoteDps

### Retornos

DPS Nacional → ABRASF

* Conversão de mensagens de retorno
* Conversão de protocolos
* Conversão de situações de lote
* Conversão de erros de processamento

## Constantes de Homologação

```csharp
const string LOCAL_HOMOLOG = "5002704";
const string SERIE_HOMOLOG = "8";
const string COD_TRIB_MUN_HOMOLOG = "7";
const string VER_APLIC = "1.0.0";
```

## Observações

* O ambiente de homologação da NFSe Nacional aceita atualmente apenas o método `RecepcionarLoteDpsSincrono`.
* O ambiente de produção utiliza o método `RecepcionarLoteDps`.
* Erros relacionados ao Simples Nacional (E0160) ou Código de Tributação Municipal (L003) podem ocorrer durante testes de homologação devido às validações cadastrais do ambiente nacional.
* Os retornos de erro do provedor são convertidos para o layout ABRASF utilizado pelo Integrador NFSe.

## Métodos Utilizados

### Produção

```text
RecepcionarLoteDps
```

### Homologação

```text
RecepcionarLoteDpsSincrono
```