Cadastre as informações iniciais obrigatórias para emissão de nota fiscal de serviço
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.
- Cobrança emitida: Para emitir uma nota fiscal de serviço, é preciso já ter criado uma cobrança e possuir um id para atrelar a nota fiscal. Esse identificador será incluído no campo ID do Objeto Receivable.
Informações importantes
Só é possível emitir uma nota fiscal por cobrança. Ao tentar emitir uma outra nota fiscal a uma cobrança que já tenha uma nota fiscal atrelada, haverá uma mensagem de erro.
Parâmetros da requisição
Parâmetro | Tipo | Descrição |
|---|---|---|
receivable obrigatório | Objeto Receivable | Objeto que detalha a cobrança que será atrelada a nota fiscal de serviço. |
fiscal_receipt\ obrigatório | Objeto FiscalReceipt | Objeto que concentra as informações de configuração da nota fiscal de serviço |
Objeto Receivable
Parâmetro | Tipo | Descrição |
|---|---|---|
id obrigatório | String | Identificador da cobrança que será atrelada a nota fiscal de serviço. Caso necessário, recomendamos o uso de nossa API de Consulta de Boletos para consulta de id de uma cobrança gerada anteriormente. |
type\ obrigatório | String | Tipo de cobrança. Nesse momento a única opção é o tipo "INVOICE". |
Objeto FiscalReceipt
Parâmetro | Tipo | Descrição |
|---|---|---|
type obrigatório | String | Indica o tipo da nota fiscal. Nesse momento aceitamos somente o tipo "NFSE" |
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 |
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. |
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 | 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. |
zip_code\ 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. |