Quais são os requisitos para a utilização desta API?

Token: possuir um token de acesso válido é essencial. Caso ainda não tenha gerado um, temos um guia detalhado disponível no tópico Fluxos de Autorização e Autenticação.
Nota Fiscal: é necessário que uma nota fiscal tenha sido emitida anteriormente.

Informações importantes

Alguns status da nota fiscal não permitem edição. Somente notas fiscais que ainda não foram emitidas (status = WAITING_TRIGGER ou WAITING_CERTIFICATE) ou retornaram erro na emissão (status = ERROR) poderão ser editadas. Notas fiscais que já foram emitidas (status = COMPLETED) ou que estão no processo de registro (status = REQUESTED) não poderão ser editadas.

Parâmetros da requisição

Parâmetro	Tipo	Descrição
id obrigatório	String	Identificador da nota fiscal na Cora.
cnae\ opcional	String	Campo com a concatenação do código do CNAE com sua respectiva descrição. O CNAE apresentado é o que foi utilizado na configuração da nota fiscal de serviço.
service_code\ opcional	String	Campo com a concatenação do código de serviço com sua respectiva descrição. O Código de serviço apresentado é o que foi utilizado na configuração da nota fiscal de serviço.
municipal_tax_code\ opcional	String	Código de tributação Municipal. Cada município tem sua própria lei que define. Consulte a legislação municipal.
description\ opcional	String	Descrição do serviço que foi inserido no momento da criação da nota fiscal. Essa descrição pode ser a mesma da cobrança atrelada, depende da escolha do cliente ao configurar.
trigger\ opcional	String	Possíveis tipos de gatilhos de emissão de nota fiscal. Consulte a descrição do Enum de Gatilhos de emissão
customer\ opcional	Objeto Customer	Objeto Customer. Representa o tomador de serviço da nota fiscal, ou seja, o cliente para quem o serviço é prestado.
tax\ obrigatório	Objeto Tax	Objeto Tax. O objeto Tax, contém as informações dos impostos declarados na nota fiscal de serviço.

Objeto Customer

Parâmetro	Tipo	Descrição
email obrigatório	String	E-mail do tomador de serviço. É para esse e-mail que a nota fiscal (PDF e XML) será enviada após ser emitida.
address\ obrigatório	Objeto Address	Endereço do tomador de serviço. Essa informação é obrigatória para configurar a nota fiscal, portanto sempre será retornada na resposta dos detalhes da nota

Objeto Address

Parâmetro	Tipo	Descrição
street obrigatório	String	Rua do tomador de serviço.
number\ obrigatório	String	Número do tomador de serviço.
district\ obrigatório	String	Bairro do tomador de serviço.
city\ obrigatório	String	Cidade do tomador de serviço.
state\ obrigatório	String	Estado (formato: SP) do tomador de serviço.
complement\ opcional	String	Campo de complemento do endereço. Esse campo pode ser nulo.
zipcode\ obrigatório	String	CEP do tomador de serviço.

Objeto Tax

Parâmetro

Tipo

Descrição

iss obrigatório

Objeto ISS

Objeto ISS.

O objeto ISS, contém a alíquota do imposto ISSQN a ser paga e se o ISS é retido na fonte ou não. Para mais informações sobre ISS, consulte nossa central de ajuda e pesquise "Como configurar a nota fiscal na Cora"

Objeto ISS

Parâmetro	Tipo	Descrição
value obrigatório	String	Valor da alíquota de imposto ISSQN configurado na nota fiscal. O formato considera os campos decimais como inteiros. Exemplo: Se o valor da alíquota for de 5% sobre o valor da nota fiscal, o campo estará preenchido com "500". Caso o valor da alíquota seja 2,5% virá preenchido com "250".
withheld\ opcional	String	Campo para definir se o ISS será retido na fonte ou não.

Tipos de Enumeradores

Enum de Status da Nota Fiscal

Parâmetro	Descrição
COMPLETED	Nota fiscal de serviço já emitida com sucesso
WAITING_TRIGGER	Aguardando o pagamento da cobrança atrelada a nota fiscal.
WAITING_CERTIFICATE	Aguardando o envio do certificado digital A1 da empresa para ser emitida. Caso o certificado seja enviado, a Cora fará e emissão automaticamente de todas as notas fiscais nesse estado.
ERROR	Houve uma tentativa de emissão que foi rejeitada pela prefeitura.

Enum de Gatilhos de emissão Nota Fiscal

Parâmetro	Descrição
COMPLETED	Nota fiscal de serviço já emitida com sucesso
WAITING_TRIGGER	Aguardando o pagamento da cobrança atrelada a nota fiscal.
WAITING_CERTIFICATE	Aguardando o envio do certificado digital A1 da empresa para ser emitida. Caso o certificado seja enviado, a Cora fará e emissão automaticamente de todas as notas fiscais nesse estado.
ERROR	Houve uma tentativa de emissão que foi rejeitada pela prefeitura.

200200

400400

422422