API regulatoria

Catálogos LFPIORPI

14 catálogos oficiales publicados por SAT / UIF para el formato Desarrollos Inmobiliarios 4.9 (DIN). Un endpoint REST por catálogo, autenticado con tu API key. Datos versionados contra el XSD oficial.

Quickstart

Todos los endpoints son GET y devuelven application/json. Bearer token en el header Authorization.

# Base URL
https://api.amigoapi.com

# Catálogos compartidos (11)
GET /lfpiorpi/catalogs/<name>

# Catálogos DIN-específicos (3)
GET /lfpiorpi/din/catalogs/<name>?xsd_version=4.9

# Búsqueda rápida por CP
GET /lfpiorpi/codigos-postales?cp=05129

# Trigger / threshold por actividad
GET /lfpiorpi/triggers/<activity_code>

11 catálogos compartidos

Reusables a través de todas las actividades LFPIORPI. Hoy expuestos para Desarrollos Inmobiliarios 4.9(DIN); las demás actividades del Art. 17 entran conforme las auditamos.

Catálogo	Filas	Descripción
`GET /lfpiorpi/catalogs/paises`	249	Países ISO 3166-1 alfa-2 + nombre en español.
`GET /lfpiorpi/catalogs/entidades-federativas`	32	32 entidades federativas mexicanas (clave SAT + nombre).
`GET /lfpiorpi/catalogs/codigos-postales`	138,283	Códigos postales nacionales con estado / municipio / colonia.
`GET /lfpiorpi/catalogs/actividades-economicas-pf`	167	Actividades económicas para persona física (catálogo SAT).
`GET /lfpiorpi/catalogs/giros-mercantiles-pm`	136	Giros mercantiles para persona moral (catálogo SAT).
`GET /lfpiorpi/catalogs/instrumentos-monetarios`	15	Instrumentos monetarios SAT (efectivo, transferencia, metales amonedados, etc.).
`GET /lfpiorpi/catalogs/instituciones-financieras`	37	Tipos de institución financiera reconocidos por SAT.
`GET /lfpiorpi/catalogs/monedas`	184	Monedas ISO 4217 + subset de metales amonedados (159..179).
`GET /lfpiorpi/catalogs/tipos-credito`	3	Tipos de crédito reconocidos por SAT.
`GET /lfpiorpi/catalogs/prioridades`	2	Prioridades del aviso: normal o 24 horas con operaciones.
`GET /lfpiorpi/catalogs/si-no`	2	Valores booleanos en formato SAT ("SI" / "NO").

3 catálogos DIN-específicos

Versionados contra el XSD oficial de Desarrollos Inmobiliarios. Filtra por versión con ?xsd_version=4.9 (default).

Catálogo	Filas	Descripción
`GET /lfpiorpi/din/catalogs/tipos-alerta`	15	Tipos de alerta para avisos DIN (códigos 3901-3913 + 9999 "Otra").
`GET /lfpiorpi/din/catalogs/tipos-desarrollo`	6	Tipos de desarrollo inmobiliario (habitacional, comercial, oficinas, industrial, mixto, otro).
`GET /lfpiorpi/din/catalogs/tipos-tercero`	3	Tipos de tercero DIN (proveedor, cliente en preventa, otro).

Ejemplo: catálogo compartido

REQUEST

curl -H "Authorization: Bearer $AMIGOAPI_KEY" \
  https://api.amigoapi.com/lfpiorpi/catalogs/paises

RESPONSE

{
  "name": "paises",
  "total": 249,
  "limit": 200,
  "offset": 0,
  "items": [
    { "code": "AF", "label": "Afganistán" },
    { "code": "AL", "label": "Albania" },
    { "code": "DE", "label": "Alemania" },
    { "code": "MX", "label": "México" },
    { "code": "US", "label": "Estados Unidos" }
  ]
}

Ejemplo: búsqueda por Código Postal

REQUEST

curl -H "Authorization: Bearer $AMIGOAPI_KEY" \
  "https://api.amigoapi.com/lfpiorpi/codigos-postales?cp=05129"

RESPONSE

{
  "cp": "05129",
  "found": true,
  "estado": "Ciudad de México",
  "municipio": "Cuajimalpa de Morelos",
  "items": [
    {
      "cp": "05129",
      "estado": "Ciudad de México",
      "municipio": "Cuajimalpa de Morelos",
      "colonia": "EL CONTADERO"
    },
    {
      "cp": "05129",
      "estado": "Ciudad de México",
      "municipio": "Cuajimalpa de Morelos",
      "colonia": "LOMAS DE VISTA HERMOSA"
    }
  ]
}

Ejemplo: catálogo DIN (tipos de alerta)

REQUEST

curl -H "Authorization: Bearer $AMIGOAPI_KEY" \
  "https://api.amigoapi.com/lfpiorpi/din/catalogs/tipos-alerta?xsd_version=4.9"

RESPONSE

{
  "name": "tipos-alerta",
  "xsd_version": "4.9",
  "total": 15,
  "limit": 200,
  "offset": 0,
  "items": [
    {
      "code": "100",
      "label": "Sin alerta"
    },
    {
      "code": "3901",
      "label": "Operación con desarrollos en preventa de alto valor"
    },
    {
      "code": "9999",
      "label": "Otra alerta"
    }
  ]
}

Ejemplo: trigger / threshold de una actividad

REQUEST

curl -H "Authorization: Bearer $AMIGOAPI_KEY" \
  https://api.amigoapi.com/lfpiorpi/triggers/din

RESPONSE

{
  "activity_code": "din",
  "fraction": "V",
  "name": "Desarrollo de bienes inmuebles",
  "thresholds": [
    {
      "type": "aviso_threshold",
      "threshold_uma": 8025,
      "operator": ">="
    }
  ],
  "reporting_period": "monthly",
  "deadline_rule": "day_17_of_following_month"
}

Obtén tu API key

Déjanos tu correo y te avisamos cuando el self-serve esté disponible. Mientras tanto, escríbenos para acceso temprano.