Gerenciamento - Data de competência

Como o eNotas 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, próprio eNotas Gateway 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 ISO 8601 e UTC, 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 pelo eNotas Gateway:

"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:

{
  “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”
}