Saltar al contenido
Constaia
us_paystub

Nómina de EE. UU. (pay stub)

Periodo, bruto, deducciones, neto y acumulado anual, con las cuentas comprobadas.

Categoría
Empleo
País
Estados Unidos
Campos que extrae
16 campos
Coste
1 crédito
us_paystubspecimen
Nombre del empleador
Employer address
Nombre del empleado
Employee id
Ssn last4
Inicio del periodo de pago
Fin del periodo de pago
Fecha de pago
Frecuencia de pago

Constaia extrae el periodo, la fecha de pago y los importes, comprueba que el bruto menos las deducciones da el neto y que los acumulados son coherentes, y verifica que la nómina es reciente y está a nombre del solicitante.

  • Que las cuentas cuadren es una señal, no una prueba.

Qué comprueba

  • Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
  • Antigüedad. Emitido hace menos de N días.

Campos que extrae

  • Nombre del empleadoremployer_name
  • Employer addressemployer_address
  • Nombre del empleadoemployee_name
  • Employee idemployee_id
  • Ssn last4ssn_last4
  • Inicio del periodo de pagopay_period_start
  • Fin del periodo de pagopay_period_end
  • Fecha de pagopay_date
  • Frecuencia de pagopay_frequency
  • Hourshours
  • Raterate
  • Salario brutogross_pay
  • Salario netonet_pay
  • Bruto acumulado del añoytd_gross
  • Neto acumulado del añoytd_net
  • Deductionsdeductions

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_paystub_specimen.pdf" \
  -F 'options={
    "expect": "us_paystub",
    "checks": {
      "max_age_days": 45,
      "reference_date": "2026-10-01",
      "holder": {
        "full_name": "Jordan Specimen"
      }
    },
    "storage": "none"
  }'

Pruébalo sin coste con una clave ck_test_ y el fichero us_paystub_specimen.pdf.

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_paystub",
    "label": "Nómina de EE. UU. (pay stub)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_paystub"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Nómina de EE. UU. (pay stub)."
      }
    ]
  },
  "fields": {
    "employee_name": {
      "value": "JORDAN SPECIMEN",
      "confidence": 0.99,
      "validated": true
    },
    "employer_name": {
      "value": "EXAMPLE LOGISTICS INC",
      "confidence": 0.98,
      "validated": null
    },
    "pay_period_start": {
      "value": "2026-09-01",
      "confidence": 0.97,
      "validated": null
    },
    "pay_period_end": {
      "value": "2026-09-15",
      "confidence": 0.96,
      "validated": null
    },
    "pay_date": {
      "value": "2026-09-19",
      "confidence": 0.99,
      "validated": null
    },
    "pay_frequency": {
      "value": "semimonthly",
      "confidence": 0.98,
      "validated": null
    },
    "gross_pay": {
      "value": 2426.69,
      "confidence": 0.97,
      "validated": null
    },
    "deductions_total": {
      "value": 612.4,
      "confidence": 0.96,
      "validated": null
    },
    "net_pay": {
      "value": 1814.29,
      "confidence": 0.99,
      "validated": null
    },
    "ytd_gross": {
      "value": 41253.73,
      "confidence": 0.98,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "pay_period_math",
      "passed": true,
      "message": "Bruto, deducciones y neto cuadran."
    },
    {
      "code": "max_age_days",
      "passed": true,
      "message": "La fecha de emisión está dentro del plazo."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "El titular coincide."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.