IN Integrador Padrão

Faturamento

CadastroNotaFiscal.integrador

ListarNotasFiscaisInutilizadas

Esse método tem por finalidade filtrar as numerações de NFe inutilizadas no ERP CIGAM, conforme indicado nos filtros exemplo a seguir:

Criar uma conta

Eu concordo com os termos de uso

Cancelar

Registrar

Entrar

Esqueceu sua senha?

Entrar

Home API Planos FAQ

Entrar

Registrar

Home API Planos FAQ

Entrar

Registrar

ReceitaWS

Mantenha seu sistema sempre atualizado com dados fiéis das empresas que se relacionam com você.
Conheça nossa API.

API: Documentação

O ReceitaWS provê uma API para recuperação de dados de empresas brasileiras através de seu CNPJ. Existem dois modos de utilização desta API:

• Modo Público
• Modo Comercial

Para entender com mais detalhes as diferenças entre estes modos de uso, é recomendada a leitura do FAQ e da página de preços. Abaixo segue a documentação específica para utilização e integração de ambos os modos.

Documentação da API Pública

Recuperar dados de uma empresa

Método para recuperar as informações de uma empresa brasileira através do seu CNPJ. As informações são exatamente as mesmas informações retornadas pelo site da Receita Federal Brasileira.

URL para requisição

GET

https://www.receitaws.com.br/v1/cnpj/[cnpj]

HTTPS

Recomendamos utilizar o HTTPS sempre que possível. Estamos mantendo suporte ao HTTP para esta API pública apenas para manter retrocompatibilidade, porém este suporte deverá ser removido em breve.

Parâmetros

• cnpj: obrigatório, numérico, o CNPJ a ser pesquisado

Exemplo de requisição

$ curl -X GET https://www.receitaws.com.br/v1/cnpj/27865757000102

Exemplo de resposta

Clique aqui para ver em seu browser.

Uma resposta típica é composta por uma matriz em JSON composta pelos seguintes campos:

Campo	Tipo	Descrição
status	string	Indica a situação da requisição. Valores possíveis: OK, ERROR.
message	string	Mensagem explicativa indicando erro. Válido apenas quando o campo status é ERROR.
billing	objeto	Indica para a requisição como foi registrado a cobrança da consulta.
billing.free	boolean	Indica se a requisição foi gratuita.
billing.database	boolean	Indica como a requisição foi resolvida: true (resolvida pelo banco de dados), false (resolvida em tempo real).
cnpj	string	CNPJ no formato 00.000.000/0000-00.
tipo	string	Valores possíveis: MATRIZ, FILIAL.
abertura	string	Data de abertura no formato dd/mm/aaaa.
nome	string	Razão social.
fantasia	string	Nome fantasia.
atividade_principal	Array<objeto>	Atividade principal. Um array com um elemento.
atividade_principal.code	string	Código CNAE da atividade no formato 00.00-0-00.
atividade_principal.text	string	Descrição da atividade.
atividades_secundarias	Array<objeto>	Atividades secundárias.
atividades_secundarias.code	string	Código CNAE da atividade no formato 00.00-0-00.
atividades_secundarias.text	string	Descrição da atividade.
natureza_juridica	string	Natureza jurídica.
logradouro	string	Logradouro.
numero	string	Número.
complemento	string	Complemento.
cep	string	CEP no formato 00.000-000.
bairro	string	Bairro.
municipio	string	Município.
uf	string	Sigla da Unidade da Federação.
email	string	Email.
telefone	string	Telefone.
efr	string	Ente Federativo Responsável, disponibilizado apenas para CNPJs da administração pública.
situacao	string	Situação.
data_situacao	string	Data da situação no formato dd/mm/aaaa.
motivo_situacao	string	Motivo da situação.
situacao_especial	string	Situação especial.
data_situacao_especial	string	Data da situação especial no formato dd/mm/aaaa.
capital_social	string	Valor do capital social no formato 0.00.
qsa	Array<objeto>	Quadro de Sócios e Administradores.
qsa.nome	string	Nome do sócio.
qsa.qual	string	Qualificação do sócio.
qsa.pais_origem	string	País de origem do sócio. Disponível apenas para sócios estrangeiros.
qsa.nome_rep_legal	string	Nome do representante legal. Disponível apenas para sócios com representantes.
qsa.qual_rep_legal	string	Qualificação do representante legal. Disponível apenas para sócios com representantes.
extra	objeto	Campo reservado para uso futuro.

Cache!

Os dados coletados são armazenados em um banco de dados local. Requisições subsequentes irão recuperar dados deste banco de dados. Mais informações podem ser obtidas em nosso FAQ.

Atualização dos Dados

Um processo é executando constantemente para atualizar os CNPJs mais antigos do banco de dados. Assim mantemos as informações dos CNPJs o mais atualizado possível. Mais informações podem ser obtidas em nosso FAQ.

JSONP

A API Pública suporta JSONP através do parâmetro callback.

Erros

O campo status indica se houve ou não erro no processamento. No caso de um erro interno no servidor ou timeouts, o header de status da resposta será diferente de 200, portanto também esteja preparado para estes erros. Timeouts podem ocorrer devido à natureza do sistema. Para mais detalhes verifique o FAQ. Esteja preparado para tratar os seguintes erros que podem ocorrer na execução da API:

CNPJ rejeitado

CNPJ rejeitado pela Receita Federal

Exemplo de resposta

{
  "status": "ERROR",
  "message": "CNPJ rejeitado pela Receita Federal"
}

CNPJ inválido

CNPJ inválido

Exemplo de resposta

{
  "status": "ERROR",
  "message": "CNPJ inválido"
}

Documentação da API Comercial

Recuperar dados de uma empresa especificando a defasagem dos dados

Para controlar a quantidade de dias entre a sua requisição e a consulta dos dados do CNPJ na Receita Federal, é possível especificar a quantidade de dias máximo entre os dois eventos, ou seja, a defasagem máxima dos dados.

Por exemplo, um CNPJ foi consultado há 32 dias e estes são os dados retornados pela API Pública. Caso necessite de uma informação mais atualizada, basta informar a quantidade máxima de dias em que a consulta à Receita é aceitável para o seu caso de uso. Informando qualquer valor menor que 32, neste caso, geraria uma nova atualização dos dados.

Utilizando a API Comercial

Para utilizar a API Comercial é necessário ter uma conta criada no site, seguir os passos necessários para a sua ativação na página Minha Conta > Configurações e gerar um token de acesso na página Minha Conta > API.

No caso da requisição gerar uma consulta à Receita Federal haverá uma cobrança em sua conta. Apenas requisições respondidas em no máximo 60 segundos serão cobradas. Veja os valores vigentes na página de valores.

Para forçar uma nova atualização, independente da última atualização dos dados, basta enviar 0 (zero) no valor do parâmetro days.

URL para requisição

GET

https://www.receitaws.com.br/v1/cnpj/[cnpj]/days/[days]

HTTPS

O uso do HTTPS é obrigatório para sua segurança. O token de acesso é o que associa a requisição à sua conta e deve ser mantido de forma segura. Não nos responsabilizamos por requisições realizadas por terceiros utilizando um token válido.

Uso no browser:

Não utilize a API Comercial diretamente no browser, pois isso implica em expor o seu token para os seus visitantes. Procure outras alternativas se a sua integração será feita em um ambiente web.

Parâmetros

• cnpj: obrigatório, numérico, o CNPJ a ser pesquisado
• days: obrigatório, numérico, quantidade máxima de dias com relação à última consulta na Receita Federal deste CNPJ

Headers

• Authorization: obrigatório, token para autenticação. Seu valor deve ser "Bearer <token>", onde <token> é o token gerado na sua conta.

Exemplo de requisição

$ TOKEN="meu-token"
$ curl -X GET -H "Authorization: Bearer $TOKEN" https://www.receitaws.com.br/v1/cnpj/27865757000102/days/10

Exemplo de resposta

Respostas da API

O formato das respostas e dos erros são os mesmos da API Pública exemplificados acima.

Menu

Home API Planos FAQ

Receita WS

Uma API para consulta de CNPJ que informa os dados das empresas e seu quadro de sócios (QSA).

Recuperar Senha

Recuperar Senha