Error 3588 SUNAT: El total valor del servicio no cumple con el formato establecido

Qué significa

SUNAT devuelve el código 3588 con el mensaje «El total valor del servicio no cumple con el formato establecido».

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

Aparece en: DAE SEAE.

Cuándo aparece

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

• DAE SEAEError

  Dato: Total valor de Servicio - operaciones gravadas (IGV) Total del IGV

  Tag UBL: /Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmount (Total valor de Servicio)

  Condición: El formato del Tag UBL es diferente de decimal positivo de 12 enteros y hasta 2 decimales y diferente de cero

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.