Notas Fiscais

Listar Configurações Fiscais

Lista as configurações fiscais da conta.

Use o id de cada uma como configId ao emitir uma nota avulsa, e como nfConfigId em cobranças, produtos e assinaturas.

A resposta traz também defaults: os valores que a API preencheria sozinha a partir do cadastro da conta — CNPJ, endereço, contato e código IBGE do município — úteis para montar a tela de cadastro já preenchida.

Segredos nunca são devolvidos. De prefeitura vêm o login, has_senha e a numeração do RPS; do certificado, se existe e a validade.

Case de uso:

Como plataforma, quero listar as empresas emissoras da conta para escolher por qual emitir cada nota.

GET/v1/invoices/notas/config

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Authorizations

bearer

Authorization

string · header · required

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

nota.fiscal/read

← Anterior

Reenviar Nota por E-mail

Consultar Configuração Fiscal

const url = 'https://sandbox.validapay.com.br/v1/invoices/notas/config';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200

{
  "configs": [
    {
      "id": "unc_1788193720141_65g0zh12p",
      "accountId": "460851686",
      "config_name": "Matriz",
      "enabled": true,
      "invoiceTiming": "IMMEDIATE",
      "codigo_tributacao_nacional_iss": "010701",
      "tributacao_iss": 1,
      "tipo_retencao_iss": 1,
      "serie_dps": "1",
      "prestador": {
        "cnpj": "99988877000108",
        "nome_fantasia": "EMPRESA EXEMPLO LTDA",
        "inscricao_municipal": "1234567",
        "codigo_municipio": "4205407",
        "codigo_municipio_prestacao": "4205407",
        "codigo_opcao_simples_nacional": 1,
        "regime_especial_tributacao": 0
      },
      "prefeitura": {
        "login": "usuario-do-portal",
        "has_senha": true,
        "serie_rps": "1",
        "proximo_numero_rps": 145
      },
      "certificate": {
        "has_certificate": true,
        "expiry_date": "2026-11-18T11:01:15.000Z"
      },
      "createdAt": "2026-08-31T16:28:43.167Z",
      "updatedAt": "2026-08-31T16:28:43.167Z"
    }
  ],
  "defaults": {
    "prestador": {
      "cnpj": "99988877000108",
      "nome_fantasia": "EMPRESA EXEMPLO LTDA",
      "email": "fiscal@exemplo.com.br",
      "telefone": "5548999999999",
      "codigo_municipio": "4205407",
      "codigo_municipio_prestacao": "4205407",
      "endereco": {
        "logradouro": "RUA DAS PALMEIRAS",
        "numero": "110",
        "bairro": "CENTRO",
        "cep": "88010000",
        "uf": "SC"
      }
    },
    "responsavel": {
      "nome": "Maria Souza",
      "cpf": "11144477735"
    }
  }
}

← Anterior

Reenviar Nota por E-mail

Consultar Configuração Fiscal