# Guía Rápida de la API de Moffin Solutions

Bienvenido a Moffin Solutions. Esta guía rápida te ayudará a comenzar con nuestra API, permitiéndote realizar tu primera consulta de datos fiscales y optimizar tus procesos.

## Paso 1: Regístrate y Obtén tu API Key

1. Visita la [página de registro de Moffin](https://moffin.mx/sign_up).
2. Crea tu cuenta e inicia sesión.
3. Accede a tu panel de control para obtener tu clave de API.


## Paso 2: Obtén tus credenciales y el token de acceso

Para autenticarte, primero necesitas obtener tu `clientId` y `clientSecret` desde tu panel de control. Luego, usa estas credenciales para solicitar un token de acceso.

### Obtener el token de acceso

Usa el siguiente comando `curl` para obtener tu token:


```bash
curl -X POST https://solutions-api.moffin.mx/api/oauth/token \
-H "Content-Type: application/json" \
-d '{
  "client_id": "TU_CLIENT_ID",
  "client_secret": "TU_CLIENT_SECRET",
  "grant_type": "client_credentials"
}'
```

### Respuesta Ejemplo


```json
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...",
  "refreshToken": "eyJhbLciOiJIUzI1CiIsInR...",
  "tokenType": "Bearer",
  "accessTokenExpiresAt": 1712345678,
  "refreshTokenExpiresAt": 1712945678
}
```

Guarda el valor de `accessToken` para usarlo en futuras solicitudes a la API.

## Paso 3: Realiza tu Primera Consulta

Comencemos con una consulta básica para obtener el CRF de un contribuyente.

### Consulta de CRF

Usa el siguiente comando `curl` para obtener la información:


```bash
curl -X POST https://solutions-api.moffin.mx/api/query/crf \
-H "Content-Type: application/json" \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-d '{
  "rfc": "XAXX010101000"
}'
```

- **`rfc`**: Registro Federal de Contribuyentes del contribuyente.


### Respuesta Ejemplo


```json
{
  "_id": "670f2ee6603fbf1c12609268",
  "service": "CRF",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PM",
    "query": {
      "rfc": "AAA010101AAA"
    }
  },
  "query": {
    "rfc": "AAA010101AAA"
  },
  "response": {
    "RFC": "AAA010101AAA",
    "RazonSocial": "Empresa Demo",
    "CodigoPostal": "11333",
    "RegimenesFiscales": [
      {
        "codigo": "626",
        "descripcion": "Régimen Simplificado de Confianza",
        "personaFisica": true,
        "personaMoral": true
      }
    ],
    "HasErrors": false,
    "Mensaje": null,
    "estatus": "Ok",
    "mensaje": null
  },
  "organizationId": 1,
  "organizationSlug": "demo",
  "profileId": 1135132,
  "createdAt": "2024-10-16T03:11:32.473Z",
  "updatedAt": "2024-10-16T03:13:20.222Z"
}
```

Esta respuesta confirma que la consulta fue exitosa y proporciona información relevante.

## ¡Felicidades!

Has realizado tu primera integración con la API de Moffin Solutions. Explora más funcionalidades en nuestra [documentación](#) o únete a nuestra [comunidad](#) para resolver tus dudas.

[Comienza tu siguiente integración](#)