Descontinuação da rota de Prestador e obrigatoriedade do campo IdIntegracao

Olá,

Tenho um comunicado importante para você!

Desde o início deste ano, estamos trabalhando em uma reestruturação do PlugNotas, para que possamos oferecer a você, a API mais inteligente do mercado. Para isso, teremos de descontinuar alguns pontos de nossa interface.

Primeira alteração
A antiga rota de cadastro de Prestador, será DESCONTINUADA. Todas as requisições para cadastro devem ser direcionadas para a rota de Empresa.

Vantagens da rota de Empresa:

  • Validação dinâmica da necessidade de Login, Senha ou Certificado Digital para o município cadastrado;
  • Um único cadastro para emissão de NF-e, NFS-e, ou NFC-e;
  • Maior estabilidade. Diversos problemas de integração foram corrigidos nesta rota;
  • Controle de modalidade de contrato (bilhetagem ou ilimitado), por API;
  • Rota para UPLOAD de logotipo.

Documentação: https://docs.plugnotas.com.br/#/Empresa/addCompany

Data limite: 31/10/2020

O que acontece após essa data? As requisições enviadas para a rota /prestador, passarão a retornar um status code de erro.

Segunda alteração
O campo IDIntegracao, passará a ser obrigatório para o envio de todos os documentos. Este campo faz a função de um IDExterno, vinculando o campo gerado por sua aplicação, à requisição enviada ao PlugNotas, deste modo, somos capazes de fazer um controle mais apurado de unicidade, permitindo somente um IDIntegracao por CNPJ Emitente.

Na prática, o que muda?
Adicione em seu JSON enviado para as rotas /nfse e /nfe, o seguinte campo:


[{..., “idIntegracao”: “XXX333”, … dados da nota}] -> Campo do tipo STRING.

Como preencho esse campo?
Utilize um código ÚNICO por CNPJ emitente, geralmente, é preenchido com o campo ID de seu banco de dados, da fatura ou registro que está gerando a nota.

Data limite: 31/10/2020

O que acontece após essa data? Requisições sem o campo idIntegracao, passarão a receber um status code de erro, indicando a falta de um campo obrigatório.

Lembre-se: essas modificações visam melhorar sua experiência com o PlugNotas.

Qual dúvida, comenta aí! :smiley:

IdIntegracao adicionado ao gerar a NF altera o formato de algo no webhook?

Olá, Leandro,

A estrutura atual do webhook não será alterada, apenas passaremos a retornar um campo a mais chamado “idIntegracao”: “com o valor que você informou na nota”.

Qualquer dúvida estou a disposição. Abraços!