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 sin coste con una clave ck_test_ y el fichero 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?

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.

Crear cuenta gratis Hablar con ventas