Notas Fiscais

Consultar Configuração Fiscal

Retorna uma configuração fiscal pelo id.

Segredos nunca são devolvidos: a senha do certificado e a senha da prefeitura ficam de fora. certificate.expiry_date traz o vencimento do certificado, e prefeitura.has_senha diz se há credencial gravada.

Configuração inexistente ou de outra conta responde {}, e não 404.

Case de uso:

Como plataforma, quero conferir a validade do certificado de uma empresa antes que ela pare de emitir.

GET/v1/invoices/notas/config/:configid

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

Path Parameters

Name	Type	Required	Description
configid	string	Required	Configid

← Anterior

Listar Configurações Fiscais

Criar Configuração Fiscal

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

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

{
  "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",
  "descricao_servico": "Prestação de Serviços",
  "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"
}

← Anterior

Listar Configurações Fiscais

Criar Configuração Fiscal