Tax status

Código de Status	Descrição
`200`	✅ Sucesso - O conteúdo está disponível no corpo da resposta.
`201`	✅ Sucesso - O conteúdo foi criado com sucesso na Belvo.
`204`	✅ Sucesso - Nenhum conteúdo para retornar.
`400`	❌ Erro de Solicitação Inválida - A solicitação retornou um erro, detalhe no conteúdo.
`401`	❌ Não Autorizado - As credenciais da Belvo fornecidas não são válidas.
`404`	❌ Não Encontrado - O recurso que você tentou acessar não pode ser encontrado.
`405`	❌ Método Não Permitido - O método HTTP que você está usando não é aceito para este recurso.
`408`	❌ Tempo de Solicitação Esgotado - A solicitação expirou e foi encerrada pelo servidor.
`428`	❌ Token MFA Necessário - O token MFA foi exigido pela instituição para conectar.
`500`	❌ Erro Interno do Servidor - O detalhe do erro está disponível no corpo da resposta.

idstring(uuid)obrigatório

Identificador único da Belvo para o item atual.

Exemplo: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

linkstring or null(uuid)obrigatório

O link.id ao qual os dados pertencem.

Exemplo: "30cb4806-6e00-48a4-91c9-ca55968576c8"

collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"

created_atstring(date-time)obrigatório

O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo.

Exemplo: "2022-02-09T08:45:50.406032Z"

place_and_date_of_issuancestring or nullobrigatório

O local e a data em que o status fiscal foi emitido.

Exemplo: "TLALPAN , CIUDAD DE MEXICO A 19 DE MARZO DE 2020"

official_namestring or nullobrigatório

O nome da pessoa ou empresa.

Exemplo: "John Doe"

id_cifstring or nullobrigatório

O Cédula de Identificación Fiscal (CIF) ID do contribuinte.

Exemplo: "12345678901"

tax_payer_informationobject or nullobrigatório

Detalhes sobre o contribuinte.

rfcstring or nullobrigatório

O número de identificação do contribuinte (para o México, este é o RFC).

Exemplo: "BEMP12345G58"

curpstring or null

O número Clave Única de Registro de Población (CURP) do contribuinte.

Exemplo: null

namestring or null

O primeiro nome do contribuinte.

Exemplo: "JOHN"

first_last_namestring or null

O primeiro sobrenome do contribuinte.

Exemplo: "DOE"

second_last_namestring or null

O segundo sobrenome do contribuinte.

Exemplo: "SCHMOE"

start_operations_datestring or null(date)obrigatório

Data em que o contribuinte iniciou atividades comerciais tributáveis, no formato YYYY-MM-DD.

Exemplo: null

status_padronstring or nullobrigatório

Status do contribuinte no Registro Federal de Contribuintes (RFC). Pode ser ACTIVO ou INACTIVO.

Exemplo: null

last_status_change_datestring or null(date)obrigatório

Data em que status_padron foi atualizado mais recentemente, no formato YYYY-MM-DD.

Exemplo: null

commercial_namestring or null

O nome da empresa designado para consumidores e o público em geral.

Nota: Aplicável apenas para empresas.

Exemplo: "Jar Jar Transport"

social_namestring or null

O nome único e exclusivo dentro do território nacional que as empresas recebem para fins legais ou administrativos.

Nota: Aplicável apenas para empresas.

Exemplo: "John Doe SA DE CV"

emailstring or null

Endereço de e-mail de contato do contribuinte.

Exemplo: "john_doe@gmail.com"

phonestring or null

Número de telefone de contato do contribuinte.

Exemplo: "1234567890"

addressobject or nullobrigatório

Os detalhes do endereço do contribuinte.

postal_codestring or nullobrigatório

O código postal do endereço.

Exemplo: "21255"

street_typestring or null

O tipo street.

Exemplo: "CALLE"

streetstring or null

A rua dos contribuintes.

Exemplo: "LA MALINCHE"

exterior_numberstring or null

O número da rua.

Exemplo: "432"

interior_numberstring or null

Informações adicionais do endereço.

Exemplo: "PLANTA BAJA"

suburbstring or null

O subúrbio do contribuinte.

Exemplo: "BUENAVENTURA"

localitystring or null

A localidade do endereço.

Exemplo: "none"

municipalitystring or null

O município do endereço.

Exemplo: "CDMX DC"

statestring or null

O estado em que o endereço está.

Exemplo: "Federal"

between_streetArray of objects or null

Informações adicionais sobre onde a street está localizada.

economic_activityArray of objects or nullobrigatório

Uma lista de objetos de atividade econômica.

economic_activitystring or null

A descrição da atividade econômica.

Exemplo: "Asalariado"

initial_datestring or null

A data de início da atividade econômica, no formato YYYY-MM-DD.

Exemplo: "2020-12-06"

end_datestring or null(date)

A data de término da atividade econômica, no formato YYYY-MM-DD.

Exemplo: null

orderstring or null

A ordem da atividade econômica.

Exemplo: "2"

percentagestring or null

A porcentagem da atividade econômica.

Exemplo: "1"

regimesArray of objects or nullobrigatório

Uma lista de objetos de regime.

end_datestring or null(date)obrigatório

A data de término do regime, no formato YYYY-MM-DD.

Exemplo: null

initial_datestring or null(date)obrigatório

A data de início do regime, no formato YYYY-MM-DD.

Exemplo: "2020-12-06"

regimenstring or nullobrigatório

A descrição do regime.

Exemplo: "Régimen de Ingresos por Dividendos (socios y accionistas)"

obligationsArray of objects or nullobrigatório

Detalhes sobre as obrigações de uma empresa.

ℹ️ Para contas não comerciais, este campo retornará vazio.

obligationstring or null

A descrição da obrigação.

Exemplo: "Declaración informativa de IVA con la anual de ISR"

expirationstring or null

O prazo para cumprir a obrigação, conforme imposto pela autoridade fiscal.

Exemplo: "Conjuntamente con la declaración anual del ejercicio."

initial_datestring or null(date)

A data em que a obrigação começou, no formato YYYY-MM-DD.

Exemplo: "2020-12-06"

end_datestring or null(date)

A data em que a obrigação terminou, no formato YYYY-MM-DD.

Exemplo: null

digital_stampstring or nullobrigatório

O certificado de validação do documento.

Exemplo: "||2020/04/26|GHTF980303F7|CONSTANCIA DE SITUACIÓN\nFISCAL|2044441088666600000034||\n"

digital_stamp_chainstring or nullobrigatório

Uma cadeia de dados contendo a estrutura básica de um cheque fiscal digital. Para o México, este é o Comprobante Fiscal Digital por Internet (CFDI).

Exemplo: "EtenSA9t1adG7bn+Jj23kj43JK+XbMPxdOppwabhXD+pXseSqYowWWDna0mpUk3264lkj2345j23faNZB852dCDt9KAjow=\n"

pdfstring or null(binary)obrigatório

PDF de status fiscal como uma string binária.

Exemplo: "=PDF-STRING="

{
  "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
  "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
  "collected_at": "2022-02-09T08:45:50.406032Z",
  "created_at": "2022-02-09T08:45:50.406032Z",
  "place_and_date_of_issuance": "TLALPAN , CIUDAD DE MEXICO A 19 DE MARZO DE 2020",
  "official_name": "John Doe",
  "id_cif": "12345678901",
  "tax_payer_information": {
    "rfc": "BEMP12345G58",
    "curp": null,
    "name": "JOHN",
    "first_last_name": "DOE",
    "second_last_name": "SCHMOE",
    "start_operations_date": null,
    "status_padron": null,
    "last_status_change_date": null,
    "commercial_name": "Jar Jar Transport",
    "social_name": "John Doe SA DE CV",
    "email": "john_doe@gmail.com",
    "phone": "1234567890"
  },
  "address": {
    "postal_code": "21255",
    "street_type": "CALLE",
    "street": "LA MALINCHE",
    "exterior_number": "432",
    "interior_number": "PLANTA BAJA",
    "suburb": "BUENAVENTURA",
    "locality": "none",
    "municipality": "CDMX DC",
    "state": "Federal",
    "between_street": [ … ]
  },
  "economic_activity": [
    { … }
  ],
  "regimes": [
    { … }
  ],
  "obligations": [
    { … }
  ],
  "digital_stamp": "||2020/04/26|GHTF980303F7|CONSTANCIA DE SITUACIÓN\nFISCAL|2044441088666600000034||\n",
  "digital_stamp_chain": "EtenSA9t1adG7bn+Jj23kj43JK+XbMPxdOppwabhXD+pXseSqYowWWDna0mpUk3264lkj2345j23faNZB852dCDt9KAjow=\n",
  "pdf": "=PDF-STRING="
}

Documentação da API Belvo (1.221.0)

Introdução

Informações Disponíveis e Métodos de Pagamento

Dicionários de Dados

Ambientes

Sandbox

Produção

Códigos de Resposta

Tratamento de Erros

Identificador de Solicitação

Códigos de Erro e Solução de Problemas

Política de Repetição

Erros 50x

Erros 40x

Campos Obsoletos

OpenAPI: campos obrigatórios e anuláveis

Institutions

Links

Widget Access Token

Consents

Owners

Accounts

Balances

Transactions

Bills

Investments Brazil

Investment Transactions Brazil

Employments Brazil

Employment Records Mexico

Invoices

Tax compliance status

Tax returns

Tax retentions

Tax status

Objeto de Status Fiscal (México)

Listar status fiscais

Requisição

▶️ Uso

📖 Paginação

🔦 Filtrando Respostas

Respostas

Quão útil foi esta página?

Recuperar status de impostos para um link

Requisição

Respostas

Quão útil foi esta página?

Financial Statements

Invoices Chile

Tax Status Chile

Debt Reports Chile

Incomes

Recurring Expenses

Risk Insights

Employment Metrics

Payment Institutions (Brazil)

Customers (Brazil)

Bank Accounts (Brazil)

Payment Links (Brazil)

Payment Intents (Brazil)

Payment Authorizations (Brazil)

Biometric Pix Widget Access Token (Brazil)

Enrollments (Brazil)

Payment Transactions (Brazil)