Criar configuração para emissão de Notas Fiscais

Cria a configuração de emissão automática de NFS-e para uma assinatura.

Após a configuração, as novas cobranças geradas pela assinatura passam a utilizar essas regras para emissão das notas fiscais. Cobranças já existentes também podem ser consideradas quando atenderem às condições configuradas.

Quando effectiveDatePeriod for BEFORE_PAYMENT_DUE_DATE, informe também daysBeforeDueDate. Os valores aceitos são 5, 10, 15, 30 ou 60.

Quando effectiveDatePeriod for ON_NEXT_MONTH, receivedOnly pode restringir a emissão às cobranças pagas. Se não for informado, o valor padrão é false.

⚠️

Preenchimento de taxes

O objeto taxes deve representar o estado completo desejado para a configuração fiscal.

Campos omitidos dentro desse objeto são interpretados com seu valor padrão, geralmente null, e não como valores que devem ser preservados.

⚠️

PIS e COFINS

Para contas de Regime Normal que emitem NFS-e pelo Portal Nacional, informe taxes.pisCofinsTaxStatus, taxes.operationPis e taxes.operationCofins conforme a situação tributária aplicável.

Não envie taxes.pisCofinsRetentionType. O valor é calculado automaticamente pelo Asaas.

Clientes do Simples Nacional não possuem alteração de payload relacionada à NT-007.

Consulte as configurações de retenção e situação tributária de PIS/COFINS.

A configuração automática não representa a autorização da NFS-e pela prefeitura. Utilize os Webhooks de notas fiscais para acompanhar a emissão, principalmente os eventos INVOICE_AUTHORIZED e INVOICE_ERROR.

Conteúdos relacionados

Guides

Path Params
string
required

Identificador único da assinatura no Asaas

Body Params
string

Identificador único do serviço municipal

string

Código de serviço municipal

string

Nome do serviço municipal

boolean

Atualizar o valor da cobrança com os impostos da nota já descontados.

number

Deduções. As deduções não alteram o valor total da nota fiscal, mas alteram a base de cálculo do ISS.

string
enum

Quando a nota fiscal será emitida

Allowed:
boolean

Emitir apenas para cobranças pagas

int32

Quantidade de dias antes do vencimento da cobrança

string

Observações adicionais da nota fiscal

taxes
object
required

Impostos da nota fiscal

Responses

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json