Error 3127 SUNAT: El XML no contiene el tag o no existe información del Codigo de BBSS de detracción para el tipo de operación

Qué significa

SUNAT devuelve el código 3127 con el mensaje «El XML no contiene el tag o no existe información del Codigo de BBSS de detracción para el tipo de operación.».

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

Aparece en: Factura, Boleta de venta, Nota de débito.

Cuándo aparece

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

• FacturaError

  Dato: Código del bien o servicio sujeto a detracción

  Tag UBL: /Invoice/cac:PaymentTerms/cbc:ID (Indicador PaymentTerms)

  Condición: Si 'Tipo de operación' es '1001', '1002', '1003' o '1004', y no existe al menos un cac:PaymentTerms con cbc:ID con valor igual a 'Detraccion'

• FacturaError

  Dato: Código del bien o servicio sujeto a detracción

  Tag UBL: /Invoice/cac:PaymentTerms/cbc:PaymentMeansID (Código de bien o servicio)

  Condición: Si 'Indicador PaymentTerms' es igual a 'Detraccion', no existe el tag o es vacío

• Boleta de ventaError

  Dato: Código del bien o servicio sujeto a detracción

  Tag UBL: /Invoice/cac:PaymentTerms/cbc:ID (Indicador PaymentTerms)

  Condición: Si 'Tipo de operación' es '1001', '1002', '1003' o '1004', y no existe al menos un cac:PaymentTerms con cbc:ID con valor igual a 'Detraccion'

• Boleta de ventaError

  Dato: Código del bien o servicio sujeto a detracción

  Tag UBL: /Invoice/cac:PaymentTerms/cbc:PaymentMeansID (Código del bien o servicio)

  Condición: Si 'Indicador PaymentTerms' es igual a 'Detraccion', no existe el tag o es vacío

• Nota de débitoError

  Dato: Código del bien o servicio sujeto a detracción

  Tag UBL: /DebitNote/cac:PaymentTerms/cbc:PaymentMeansID (Código de bien o servicio)

  Condición: Si 'Indicador PaymentTerms' es igual a 'Detraccion', no existe el tag o es vacío

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.