Error 2694 SUNAT: El número de documento relacionado no está permitido o no es valido

Qué significa

SUNAT devuelve el código 2694 con el mensaje «El número de documento relacionado no está permitido o no es valido».

Es un error: SUNAT rechaza el comprobante y no tiene validez tributaria.

Aparece en: Comprobante de retención, Comprobante de percepción.

Cuándo aparece

Estas son las reglas de validación de SUNAT que devuelven el código 2694, con su texto oficial:

• Comprobante de retenciónError

  Dato: Serie y número del documento relacionado

  Tag UBL: /Retention/sac:SUNATRetentionDocumentReference/cbc:ID

  Condición: Si "Tipo de documento relacionado" es "12", el formato del Tag UBL es diferente a: - [a-zA-Z0-9-]{1,20}(-[0-9]{1,20})

• Comprobante de retenciónError

  Dato: Serie y número del documento relacionado

  Tag UBL: /Retention/sac:SUNATRetentionDocumentReference/cbc:ID

  Condición: Si "Tipo de documento relacionado" es diferente a "12", el formato del Tag UBL es diferente a: (E001|((F|R)[A-Z0-9]{3})|([0-9]{4}))-(?!0+$)([0-9]{1,8})

• Comprobante de percepciónError

  Dato: Serie y número correlativo del documento relacionado

  Tag UBL: /Perception/sac:SUNATPerceptionDocumentReference/cbc:ID

  Condición: Si "Tipo de documento relacionado" es "12", el formato del Tag UBL es diferente a: - [a-zA-Z0-9-]{1,20}(-[0-9]{1,20})

• Comprobante de percepciónError

  Dato: Serie y número correlativo del documento relacionado

  Tag UBL: /Perception/sac:SUNATPerceptionDocumentReference/cbc:ID

  Condición: Si "Tipo de documento relacionado" es diferente a "12", el formato del Tag UBL es diferente a: (E001|EB01|((F|P|B)[A-Z0-9]{3})|([0-9]{4}))-(?!0+$)([0-9]{1,8})

Cómo resolverlo

Revisa el dato y el tag UBL que indica la regla y corrígelo para que no se cumpla la condición de SUNAT.

Si SUNAT ya rechazó el comprobante, su número queda usado: no lo reenvíes igual. Corrige los datos y emite un comprobante nuevo.

Cómo lo ves en API SUNAT

Con API SUNAT no armas el XML: envías la venta en JSON y la API lo genera, lo firma y lo envía a SUNAT. Si SUNAT rechaza el comprobante, la emisión responde con status "rejected" y el código en sunat.errorCode y sunat.errorMessage; las observaciones llegan con status "accepted_with_observations".

También puedes recibirlo por webhook (document.rejected o document.observed). Ver los estados en la documentación.