# Visão Geral da Agregação Fiscal (México)

> Simplifique sua conformidade fiscal e relatórios financeiros no México com nosso produto de Agregação Fiscal. Recupere de forma integrada documentos financeiros e fiscais críticos do SAT (Servicio de Administración Tributaria) do México para otimizar suas operações e atender aos requisitos regulatórios.


## Introdução

Nosso produto **Fiscal Aggregation (Mexico)** oferece um conjunto abrangente de recursos que se integra com o SAT (Servicio de Administración Tributaria) do México para automatizar a recuperação de documentos financeiros e fiscais críticos. Esses recursos fornecem às empresas as ferramentas para gerenciar a conformidade fiscal, relatórios financeiros e requisitos regulatórios de forma mais eficiente.

Nosso produto Fiscal Aggregation (Mexico) fornece acesso aos seguintes recursos:

| Recurso  | Descrição |
|  --- | --- |
| Demonstrações Financeiras | Obtenha uma compreensão abrangente da saúde financeira de uma empresa com nosso recurso de Demonstrações Financeiras. Acesse visões gerais detalhadas, incluindo balanços patrimoniais e demonstrações de resultados específicas do México. Estas fornecem uma visão completa da posição e desempenho financeiro de uma empresa, cobrindo ativos, passivos, patrimônio, receitas e despesas para qualquer ano. Este recurso é essencial para análises financeiras perspicazes e tomada de decisões estratégicas para empresas que operam no México. |
| Faturas | **Recupere e gerencie dados de transações sem esforço** com nosso recurso de Faturas. Acesse informações diretamente do SAT do México sobre *Facturas Electrónicas* (*CFDIs*), o registro oficial de transações entre empresas e indivíduos. Cada fatura fornece detalhes críticos sobre bens ou serviços, pagamentos, impostos aplicáveis e o status fiscal de todas as partes envolvidas, simplificando seus processos contábeis e de conformidade.O SAT impõe limites no número de faturas que você pode baixar por dia. Para mais informações, bem como possíveis soluções alternativas, consulte nosso artigo do centro de ajuda.
 |
| Retenções Fiscais | **Simplifique sua conformidade com as regulamentações de retenção de impostos** usando nosso recurso de Retenções Fiscais. Recupere informações abrangentes do SAT do México sobre retenções (*retenciones*) feitas ou recebidas por qualquer contribuinte (pessoa física ou jurídica). Esses relatórios cobrem pagamentos sujeitos a retenção de impostos, como aqueles para funcionários, contratados ou prestadores de serviços, bem como outras transações financeiras, garantindo relatórios precisos e minimizando riscos de conformidade. |
| Declarações Fiscais | **Acesse informações abrangentes de arquivamento fiscal** com nosso recurso de Declarações Fiscais, fornecendo tanto declarações fiscais anuais quanto mensais (*Declaraciones Fiscales*) arquivadas no SAT.- **Declarações Fiscais Anuais (*Declaración Anual*):** Obtenha um resumo completo da atividade financeira de uma empresa ou indivíduo para todo o ano fiscal, incluindo receitas, despesas, deduções e impostos devidos ou reembolsáveis, para relatórios anuais precisos.
- **Declarações Fiscais Mensais (*Declaración Mensual*):** Mantenha-se em dia com suas obrigações fiscais contínuas com resumos detalhados de receitas mensais, IVA, impostos sobre a folha de pagamento e outros impostos relevantes, garantindo submissões pontuais e precisas.

A estrutura de dados será diferente dependendo se é uma declaração fiscal mensal ou anual, bem como se está relacionada a uma pessoa ou a uma empresa (você encontrará exemplos para ambos na referência da API)
 |
| Status Fiscal | **Verifique rápida e facilmente informações chave do contribuinte** com nosso recurso de Status Fiscal. Recupere o documento oficial *Constancia de Situación Fiscal* diretamente do SAT, contendo detalhes vitais sobre uma pessoa física ou entidade empresarial, como seu ID Fiscal (RFC), regime fiscal, endereço registrado e atividades econômicas. Isso é crucial para due diligence, integração e garantia de conformidade.A estrutura de dados do status fiscal será diferente dependendo se está relacionada a uma pessoa ou a uma empresa
 |
| Status de Conformidade Fiscal | **Confirme instantaneamente o status de conformidade fiscal de indivíduos e empresas** usando nosso recurso de Status de Conformidade Fiscal. Acesse o documento oficial *Opinión de Cumplimiento de Obligaciones Fiscales* do SAT, que certifica definitivamente se uma entidade está em dia com suas obrigações fiscais. Isso é essencial para avaliar parceiros de negócios, fornecedores e garantir a adesão regulatória. |


## Instituições Disponíveis

| Nome | Recursos Disponíveis | MFA | Produtos Suportados |
|  --- | --- | --- | --- |
| SAT`sat_mx_fiscal` | 🟢 Demonstrações Financeiras🟢 Faturas🟢 Retenções Fiscais🟢 Declarações Fiscais🟢 Status Fiscal🟢 Status de Conformidade Fiscal | Sim (para Faturas) | 🟢 Pessoal 🟢 Empresarial |
| Sandbox`tatooine_mx_fiscal` | 🟢 Faturas🟢 Declarações Fiscais🟢 Status Fiscal🟢 Status de Conformidade Fiscal | Não | 🟢 Pessoal 🟢 Empresarial |


## Conectando Usuários (Links)

Para extrair dados sobre seus usuários, eles precisarão conectar suas contas usando a Belvo API (veja as opções de integração abaixo). Quando eles conectam suas contas, criamos um *link* entre o usuário e a instituição.

```mermaid
sequenceDiagram
    participant App as Application
    participant Inst as Institution

    App->>Inst: User connects to the financial institution using Belvo
    Inst-->>App: "Link" established
```

Dependendo do seu caso de uso, oferecemos dois tipos diferentes de links:

| Tipo de Link  | Descrição |
|  --- | --- |
| Recorrente | Os dados são automaticamente recuperados em um intervalo determinado (diário, semanal, mensal) e você é notificado via webhook. Ideal para monitoramento contínuo e insights atualizados. |
| Único | Os dados são recuperados "sob demanda". Útil para avaliações únicas ou solicitações iniciadas pelo usuário. |


Para mais informações sobre tipos de links, os intervalos de atualização e quais dados são extraídos automaticamente, consulte nosso artigo dedicado a Links.

## Opções de Integração

Para extrair dados fiscais no México, você pode usar as seguintes opções de integração:

### Belvo Hosted Widget

Para aplicativos nativos (mobile) e também web-based, criamos uma versão **hosted** do nosso **widget** que simplifica significativamente o seu processo de desenvolvimento e integração. Tudo o que é necessário é que você crie uma **webview** em seu aplicativo e tenha algum conhecimento sobre como lidar com redirecionamentos de **deeplink**.

```mermaid
sequenceDiagram
    participant App as Aplicativo
    participant Belvo as Belvo
    participant Institution as Instituição Fiscal

    App->>Belvo: POST /token/
    Note over App,Belvo: fetch_resources=[INVOICES, TAX_RETURNS ...]
    Belvo-->>App: 200 - Token Gerado

    App->>Belvo: Direcione seu usuário para o Hosted Widget
    Belvo->>Institution: Usuário faz login na sua instituição
    Belvo-->>App: Usuário redirecionado de volta para seu aplicativo + link gerado
    
    Belvo->>Institution: Belvo recupera informações históricas para o ID do Link

    Note over App,Institution: Para cada recurso listado em fetch_resources, você irá<br/>receber um webhook de historical_update.

    Belvo->>App: WEBHOOK: historical_update (INVOICES)
    App->>Belvo: GET /invoices/?link={id}
    Belvo-->>App: 200 + Detalhes da Fatura

    Note over App,Institution: Se estiver usando links recorrentes, na frequência de atualização agendada<br/>você receberá um webhook de new_{resource}_available.

    Belvo->>App: WEBHOOK: new_tax_returns_available
    App->>Belvo: GET /tax-returns/?link={link.id}
    Belvo-->>App: 200 + Detalhes da Declaração de Imposto
```

### API Direta

Você também pode integrar diretamente com nossa API, dando a você controle completo do processo de integração e coleta de credenciais.

```mermaid
sequenceDiagram
    participant App as Application
    participant Belvo as Belvo
    participant Institution as Fiscal Institution

    App->>Belvo: POST /links/
    Note over App,Belvo: fetch_resources=[INVOICES, TAX_RETURNS ...]
    Belvo->>Institution: Conectar e confirmar as credenciais fornecidas
    Belvo-->>App: 201 - Link Criado + Link ID
    
    Belvo->>Institution: Belvo recupera informações históricas para o Link ID

    Note over App,Institution: Para cada recurso listado em fetch_resources, você irá<br/>receber um webhook de historical_update.

    Belvo->>App: WEBHOOK: historical_update (INVOICES)
    App->>Belvo: GET /invoices/?link={id}
    Belvo-->>App: 200 + Detalhes da Fatura

    Note over App,Institution: Se estiver usando links recorrentes, na frequência de atualização agendada<br/>você receberá um webhook de new_{resource}_available.

    Belvo->>App: WEBHOOK: new_tax_returns_available
    App->>Belvo: GET /tax-returns/?link={link.id}
    Belvo-->>App: 200 + Detalhes da Declaração de Imposto
```