Listar serviços municipais

Endpoint utilizado para consultar os serviços municipais disponíveis para emissão de nota fiscal.

Essa chamada retorna os serviços cadastrados para o município da conta e ajuda a identificar qual serviço deve ser informado no agendamento da nota fiscal.

Parâmetros de consulta

  • offset - Define a posição inicial da listagem.

  • limit - Define a quantidade de registros retornados por requisição. O limite máximo é 100.

  • description - Permite filtrar os serviços pelo nome ou descrição.

Como interpretar o retorno

Cada serviço normalmente possui informações como:

  • id - Identificador único do serviço municipal no Asaas.

  • description - Descrição do serviço. Em muitos casos, esse campo já inclui o código municipal.


📘

Atenção

Quando a prefeitura disponibiliza lista de serviços, o recomendado é utilizar o id retornado nessa listagem no campo municipalServiceId ao agendar a nota fiscal.

  • Nesse cenário, não é necessário repetir o código em municipalServiceCode.
  • O preenchimento incorreto do serviço municipal pode causar falhas na emissão da nota fiscal.

Importância da consulta

Esse endpoint é útil para evitar preenchimento manual incorreto do serviço municipal.

Query Params
integer
integer
≤ 100
string
Responses

403

Forbidden. Ocorre quando o body da requisição está preenchido, chamadas de método GET precisam ter um body vazio.

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