us_w2Formulario 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 fiscal
tax_year - EIN del empleador
employer_ein - Employer
employer - SSN del empleado
employee_ssn - Nombre del empleado
employee_name - Employee address
employee_address - Salarios, propinas y otras retribuciones
wages - Federal income tax withheld
federal_income_tax_withheld - Salarios sujetos a Seguridad Social
social_security_wages - Social security tax withheld
social_security_tax_withheld - Salarios sujetos a Medicare
medicare_wages - Medicare tax withheld
medicare_tax_withheld - Estado
state - Salarios estatales
state_wages - State income tax
state_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.