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
- Visita la página de registro de Moffin.
- Crea tu cuenta e inicia sesión.
- 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:
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
{
"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:
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
{
"_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.