GUÍA

Primeros pasoscon el API partner.

Integra el cálculo fiscal mexicano con autenticación por API key, catálogos nacionales y los motores fiscales de AlloraHR.

Solicita una API key

Contacta al equipo comercial o de partnerships. Las llaves sandbox usan environment=test y el módulo partner_calculations.

Autentica con Bearer

Envía Authorization: Bearer al_plt_… en cada request. No se requiere X-Company-Id. Los POST de cálculo usan scope platform:read.

Llama un endpoint de cálculo

Empieza con POST /api/v1/partner/calculate/mx/payroll o GET /api/v1/partner/version para confirmar contract_version=v1.

Respeta el rate limit

El límite es 120 requests por minuto por llave. Ante 429, espera y reintenta con backoff.

Ejemplo · curl (ilustrativo)

curl -sS https://api.allorahr.com/api/v1/partner/calculate/mx/payroll \
  -H "Authorization: Bearer al_plt_…" \
  -H "Content-Type: application/json" \
  -d '{
    "gross_salary": 45000,
    "period": "monthly",
    "year": 2026,
    "worker_type": "employee",
    "state": "JAL"
  }'

Módulopartner_calculations

Scopeplatform:read

Rate limit120 req/min

Contratocontract_version=v1

El host del ejemplo es ilustrativo. La URL base y el entorno (sandbox o producción) se confirman al emitir la llave. OpenAPI filtrado: GET /api/partner/openapi — misma auth Bearer, sin X-Company-Id.

Ir a la referencia →Solicitar acceso