# Moffin Solutions API

API para la consulta de datos fiscales y financieros de contribuyentes.

Version: 1.0.0

## Servers

Servidor de producción
```
https://solutions-api.moffin.mx/api
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Moffin Solutions API](https://solutions-docs.moffin.mx/_bundle/apis/index.yaml)

## Authentication

### Crear y refrescar token

 - [POST /oauth/token](https://solutions-docs.moffin.mx/apis/authentication/createtoken.md)

## Consultas Empresariales

### Consulta de información de accionistas por RFC

 - [POST /query/company-shareholders](https://solutions-docs.moffin.mx/apis/consultas-empresariales/requestcompanyshareholders.md): Permite obtener información detallada sobre los accionistas de una empresa a partir de su RFC. 
La información incluye datos como nombre, nacionalidad, porcentaje de participación y más.

La respuesta inicial confirmará el procesamiento de la consulta, y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:
json
{
    "message": "Consulta de SHAREHOLDERS procesada exitosamente.",
    "queryId": "6791b216ddf6a1c971a08624"
}

## Consultas Fiscales

### Calcula el RFC de una Persona Física

 - [POST /query/rfc-calculator](https://solutions-docs.moffin.mx/apis/consultas-fiscales/calculaterfc.md): Este endpoint permite calcular el RFC (Registro Federal de Contribuyentes) de una persona física proporcionando su nombre, apellidos y fecha de nacimiento.

### Consulta de Constancia de Régimen Fiscal (CRF)

 - [POST /query/crf](https://solutions-docs.moffin.mx/apis/consultas-fiscales/requestcrf.md): Permite obtener la Constancia de Régimen Fiscal (CRF) de un contribuyente a partir de su RFC.
La respuesta inicial confirmará el procesamiento de la consulta, y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:
json
{
    "message": "Consulta de Certificado de régimen fiscal procesada exitosamente.",
    "queryId": "6791b216ddf6a1c971a08624"
}

### Consulta de Datos del RFC

 - [POST /query/rfc-data](https://solutions-docs.moffin.mx/apis/consultas-fiscales/requestrfcdata.md): Permite obtener la información detallada del RFC de un contribuyente.
La respuesta inicial confirmará el procesamiento de la consulta, y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:
json
{
    "message": "Consulta de RFC procesada exitosamente.",
    "queryId": "6791b7b4ddf6a1c971a08625"
}

### Consulta de datos de CURP

 - [POST /query/curp-data](https://solutions-docs.moffin.mx/apis/consultas-fiscales/requestcurpdata.md): Permite obtener información de un CURP, incluyendo datos personales y el RFC asociado.

## Consultas de Historial Laboral

### Consulta de Historial Laboral

 - [POST /query/job-history](https://solutions-docs.moffin.mx/apis/consultas-de-historial-laboral/requestjobhistory.md): Permite obtener el historial laboral de un contribuyente a partir de su CURP.
La respuesta inicial confirmará el procesamiento de la consulta, y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:
json
{
    "message": "Consulta de historial laboral procesada exitosamente.",
    "queryId": "6791b7b4ddf6a1c971a08626"
}

## Consultas al SAT

### Creación de perfil SAT

 - [POST /query/sat/profile](https://solutions-docs.moffin.mx/apis/consultas-al-sat/createprofilesat.md): Para realizar consultas al SAT, primero es necesario crear el perfil de la persona a consultar proporcionando su RFC y CIEC.

### Consulta de Situación Fiscal (CSF)

 - [POST /query/sat/csf](https://solutions-docs.moffin.mx/apis/consultas-al-sat/requestprofilecsf.md): Permite consultar la situación fiscal de un contribuyente mediante su RFC.

Nota: Antes de realizar esta consulta, es necesario crear un perfil SAT con el RFC y la CIEC.

Body de la solicitud:
json
{
    "rfc": "MOCKRFC123456"
}

### Consulta de Opinión de Cumplimiento (32D)

 - [POST /query/sat/compliance-opinion](https://solutions-docs.moffin.mx/apis/consultas-al-sat/requestprofile32d.md): Permite obtener la Opinión de Cumplimiento (32D) de un contribuyente a partir de su RFC.

Nota: Antes de realizar esta consulta, es necesario crear un perfil SAT con el RFC y la CIEC.

Importante: La respuesta inicial confirmará el procesamiento de la consulta y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:
json
{
    "message": "Solicitud de 32D procesada exitosamente",
    "queryId": "6791b7b4ddf6a1c971a08625"
}

### Consulta de Facturas SAT

 - [POST /query/sat/invoice](https://solutions-docs.moffin.mx/apis/consultas-al-sat/requestprofileinvoice.md): Permite obtener las facturas de un contribuyente a partir de su RFC y un período de consulta.

Nota: Antes de realizar esta consulta, es necesario crear un perfil SAT con el RFC y la CIEC.

Importante: La respuesta inicial confirmará el procesamiento de la consulta y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:
json
{
    "message": "Solicitud de facturas procesada exitosamente",
    "results": [
        {
            "queryId": "6791c6756a250515924f140f",
            "period": "2025-1",
            "status": "PENDING"
        },
        {
            "queryId": "6791c6796a250515924f1411",
            "period": "2024-12",
            "status": "PENDING"
        }
    ]
}

## Query Retrieval

### Obtener todas las consultas realizadas

 - [GET /query](https://solutions-docs.moffin.mx/apis/query-retrieval/getallqueries.md): Devuelve una lista de todas las consultas realizadas en el sistema.

### Obtener una consulta específica por ID

 - [GET /query/{queryId}](https://solutions-docs.moffin.mx/apis/query-retrieval/getquerybyid.md): Devuelve los detalles de una consulta específica a partir de su ID.