## Prefeitura / MG / Contagem / NFS-e (Nota Fiscal Eletrônica de Serviços)
Consulta uma Nota Fiscal Eletrônica de Serviços na Prefeitura do município de Contagem e retorna os dados da nota obtidos a partir da aplicação de um OCR.
### Site URL
- https://contagem.ginfes.com.br/
### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/pref/mg/contagem/nfs`
| Parameter | Description |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token* | The token that will authenticate and authorize the request. |
| numero_nota* | Numero_nota |
| codigo_verificacao* | Codigo_verificacao |
| cpf_cnpj_prestador* | Cpf_cnpj_prestador |
| declaracao* | Aqui deve ser informado o valor 1 para aceitar ou 0 para recusar a seguinte declaração presente no formulário da fonte:
Declaro, para todos os fins, ser parte da relação comercial apontada no documento fiscal que será exibido |
> * Required parameter.
> ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly.
### Response examples (OK)
```json
{
"code": 200,
"code_message": "A requisição foi processada com sucesso.",
"errors": [],
"header": {
"api_version": "v2",
"api_version_full": "2.2.10-20230810102743",
"product": "Consultas",
"service": "pref/mg/contagem/nfs",
"parameters": {
"codigo_verificacao": "XXXXXXXX",
"cpf_cnpj_prestador": "12.345.678/9012-34",
"declaracao": "1",
"numero_nota": "1234"
},
"client_name": "Minha Empresa",
"token_name": "Token de Produção",
"billable": true,
"price": "0.24",
"requested_at": "2023-08-11T13:24:52.000-03:00",
"elapsed_time_in_milliseconds": 170,
"remote_ip": "111.111.111.111",
"signature": "U2FsdGVkX18sMTk2fbiHdEgF2ZWLooCLvowaT2w93CCLmhZV2qlcLtDILw6nAvVO7gGDxLUzbsh+x8emzpNMtw=="
},
"data_count": 1,
"data": [
{
"avisos": "Exemplo de Aviso",
"ocr_codigo_art": "",
"ocr_codigo_obra": "",
"ocr_codigo_servico": "1111 - Exemplo de serviço",
"ocr_codigo_verificacao": "XXXXXXXX",
"ocr_competencia": "14/2/2022",
"ocr_data_hora_emissao": "14/02/2022 08:58:40",
"ocr_desconto_condicionado": "0.00",
"ocr_desconto_incondicionado": "0.00",
"ocr_discriminacao": "Exemplo de discriminação",
"ocr_incentivador_cultural": "Não",
"ocr_issqn_a_reter": "Não",
"ocr_issqn_aliquota": "5.00",
"ocr_issqn_base_calculo": "108.00",
"ocr_issqn_deducoes_permitidas": "0.00",
"ocr_issqn_desconto_incondicionado": "0.00",
"ocr_issqn_retido": "0.00",
"ocr_issqn_valor": "5.40",
"ocr_issqn_valor_servico": "108.00",
"ocr_local_prestacao": "CONTAGEM - MG",
"ocr_natureza_operacao": "1-Tributação no município",
"ocr_numero_nota": "11111",
"ocr_numero_nota_sub": "11111",
"ocr_numero_rps": "11111",
"ocr_outras_retencoes": "0.00",
"ocr_prestador_complemento": "",
"ocr_prestador_cpf_cnpj": "12345678901234",
"ocr_prestador_email": "exemplo@email.com",
"ocr_prestador_endereco_cep": "",
"ocr_prestador_inscricao_municipal": "11111111",
"ocr_prestador_municipio": "São Paulo",
"ocr_prestador_nome": "Exemplo de Nome",
"ocr_prestador_nome_fantasia": "",
"ocr_prestador_telefone": "(11)1111-1111",
"ocr_regime_especial_tributacao": "0-Nenhum",
"ocr_retencoes_federais": "6.64",
"ocr_simples_nacional": "Não",
"ocr_tomador_complemento": "",
"ocr_tomador_cpf_cnpj": "12345678901234",
"ocr_tomador_email": "exemplo@email.com",
"ocr_tomador_endereco_cep": "Avenida Paulista, 807",
"ocr_tomador_inscricao_municipal": "11111111",
"ocr_tomador_municipio": "São Paulo",
"ocr_tomador_nome": "Exemplo de Nome",
"ocr_tomador_telefone": "",
"ocr_valor_cofins": "3.24",
"ocr_valor_csll": "1.08",
"ocr_valor_inss": "",
"ocr_valor_ir": "1.62",
"ocr_valor_liquido": "101.36",
"ocr_valor_pis": "0.70",
"ocr_valor_servico": "108.00",
"site_receipt": "https://www.exemplo.com/exemplo-de-url"
}
],
"site_receipts": [
"https://www.exemplo.com/exemplo-de-url"
]
}
```
### Preview file
The preview file (`site_receipts`) in the response JSON is **generated by the source (website/app)** that processed the automation.
### Code snippets
#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests
url = 'https://api.infosimples.com/api/v2/consultas/pref/mg/contagem/nfs'
args = {
"numero_nota": "VALUE_OF_PARAMETER_NUMERO_NOTA",
"codigo_verificacao": "VALUE_OF_PARAMETER_CODIGO_VERIFICACAO",
"cpf_cnpj_prestador": "VALUE_OF_PARAMETER_CPF_CNPJ_PRESTADOR",
"declaracao": "VALUE_OF_PARAMETER_DECLARACAO",
"token": "WRITE_YOUR_TOKEN_HERE",
"timeout": "300"
}
response = requests.post(url, args)
response_json = response.json()
response.close()
if response_json['code'] == 200:
print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
mensagem += "; ".join(response_json['errors'])
print(mensagem)
print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```
## We are here to help
Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.