Saltar al contenido
Constaia
us_w2

Formulario W-2 (IRS)

Empleador, EIN, salarios y retenciones de un W-2.

Categoría
Impuestos
País
Estados Unidos
Campos que extrae
15 campos
Coste
1 crédito
us_w2specimen
Ejercicio fiscal
EIN del empleador
Employer
SSN del empleado
Nombre del empleado
Employee address
Salarios, propinas y otras retribuciones
Federal income tax withheld
Salarios sujetos a Seguridad Social

Constaia extrae el ejercicio, el empleador, el EIN y los importes de las casillas, comprueba los formatos del EIN y el SSN y compara el nombre del empleado.

Qué comprueba

  • Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).us_ein, us_ssn
  • Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.

Campos que extrae

  • Ejercicio fiscaltax_year
  • EIN del empleadoremployer_ein
  • Employeremployer
  • SSN del empleadoemployee_ssn
  • Nombre del empleadoemployee_name
  • Employee addressemployee_address
  • Salarios, propinas y otras retribucioneswages
  • Federal income tax withheldfederal_income_tax_withheld
  • Salarios sujetos a Seguridad Socialsocial_security_wages
  • Social security tax withheldsocial_security_tax_withheld
  • Salarios sujetos a Medicaremedicare_wages
  • Medicare tax withheldmedicare_tax_withheld
  • Estadostate
  • Salarios estatalesstate_wages
  • State income taxstate_income_tax

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_w2_specimen.pdf" \
  -F 'options={
    "expect": "us_w2",
    "checks": {
      "holder": {
        "full_name": "Jordan Specimen"
      },
      "require_fields": [
        "wages",
        "tax_year"
      ]
    },
    "storage": "none"
  }'

Pruébalo gratis en modo de prueba con el archivo us_w2_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_w2",
    "label": "Formulario W-2 (IRS)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_w2"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Formulario W-2 (IRS)."
      }
    ]
  },
  "fields": {
    "tax_year": {
      "value": 2025,
      "confidence": 0.99,
      "validated": true
    },
    "employee_name": {
      "value": "JORDAN L SPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "employee_ssn": {
      "value": "XXX-XX-6789",
      "confidence": 0.97,
      "validated": null
    },
    "employer_name": {
      "value": "EXAMPLE LOGISTICS INC",
      "confidence": 0.96,
      "validated": null
    },
    "employer_ein": {
      "value": "12-3456789",
      "confidence": 0.99,
      "validated": null
    },
    "wages": {
      "value": 58240.5,
      "confidence": 0.98,
      "validated": null
    },
    "federal_tax_withheld": {
      "value": 6120,
      "confidence": 0.97,
      "validated": null
    },
    "state": {
      "value": "IL",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "ein_format",
      "passed": true,
      "message": "El EIN tiene un formato válido."
    },
    {
      "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?

Solo si hay que revisarlo: entonces se guarda cifrado hasta que se decide y 24 horas más (configurable). Si no, se borra en cuanto termina el análisis. Puedes elegir no guardarlo nunca.

Otros documentos

Y para que conste…

Crea tu cuenta gratis y valida tu primer documento en cinco minutos. Sin tarjeta.