---
updatedAt: 2026-05-20T21:25:40.000Z
agentTools:
  projectIndex: https://docs.notagateway.com.br/llms.txt
---

# Gerenciamento - Data de competência

Como a Nota Gateway gerencia a data de competência da nota fiscal de serviço e como você pode personalizá-la.

## Entendendo a Data de competência:

Uma das funções primordiais do Gateway é administrar automaticamente a data de competência das NFS-e.

Por isso, o atributo de informar a data de competência ("dataCompetencia") não fica exposto nos JSON de exemplo da API.

## Como a data de competência é administrada?

Ao solicitar a emissão de uma nota fiscal de serviço sem especificar uma data de competência, a API define a data de competência como a atual.

> 🚧 Data de competência e reprocessamento:
>
> Caso a nota seja rejeitada pela prefeitura e você a retransmita (independente da data de reprocessamento), **ainda sem especificar nenhuma data**, a competência da nota permanece a mesma que o dia da primeira tentativa.

## Formato padrão do atributo "dataCompetencia":

A padronização do atributo de data de competência segue o formato <a href="https://www.iso.org/iso-8601-date-and-time-format.html" target="_blank">ISO 8601</a> e <a href="https://pt.wikipedia.org/wiki/Tempo_Universal_Coordenado" target="_blank">UTC</a>, que é representado pela seguinte configuração:

**YYYY-MM-DDThh:MM:ssZ**

* YYYY = Ano (Year)
* MM = Mês (Month)
* DD = Dia (Day)
* HH = Hora (Hour)
* MM = Minutos (Minutes)
* SS = Segundo (Seconds)

## Como utilizar o atributo:

Caso deseje administrar internamente a data de competência no seu sistema, basta observar os exemplos abaixo:

Data de competência desejada: 01-07-2019 às 08:15:00;

• Como o atributo deve ser **enviado no momento da emissão** (método POST):

**"dataCompetencia": "2019-07-01T08:15:00Z"**

• Como o atributo é **exibido no JSON de retorno** da nota gerada pela API:

**"dataCompetenciaRps": "2019-07-01T08:15:00Z"**

> ❗️ Importante notar:
>
> O atributo **"dataCompetencia"** sofre uma **mudança de nome** ao ser identificado no JSON de retorno da nota gerada, passando a ser **"dataCompetenciaRps"**.

Logo abaixo temos um exemplo do atributo na prática:

```json
{
  “ambienteEmissao”: “Homologacao”,
  “dataCompetencia”: “2016-10-17T22:02:51Z”,
  “cliente”: {
    “cpfCnpj”: “string”,
    “endereco”: {
      …
    },
    “telefone”: “string”
  },
  “enviarPorEmail”: true,
  “servico”: {
  	“descricao”: “string”
  },
“valorTotal”: 1.47,
“observacoes”: “Sua observação pode ser inserida neste atributo”
}
```