Skip to content

Anular retención ​

POST /api/Invoice/cancel_retention

Anula un comprobante de retención de IVA o de ISLR emitido por el negocio del token. La anulación marca el comprobante completo (todas sus líneas) como Anulada y devuelve el enlace al PDF anulado.

Autenticación: Authorization: Bearer <token> (cómo obtenerlo) · Content-Type: application/json

Cuerpo de la solicitud ​

CampoTipoObligatorioDescripción y reglas
numero_comprobantestringSíNúmero de comprobante tal como lo devolvió la emisión o la consulta (AAAAMM + correlativo, p. ej. 20260700000012). Se eliminan los caracteres que no sean letras o números; el resultado debe tener al menos 7 caracteres.
numero_controlstringSíNúmero de control del comprobante, exactamente como fue asignado (p. ej. 00-00000070).
tipo_documentostringSíIVA o ISLR (no distingue mayúsculas; se ignoran espacios al inicio y al final).

Los nombres de las claves no distinguen mayúsculas (NUMERO_COMPROBANTE también se acepta).

Ejemplo de solicitud ​

json
{
  "numero_comprobante": "20260700000012",
  "numero_control": "00-00000070",
  "tipo_documento": "IVA"
}

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "message": "La retención de IVA ha sido anulada correctamente.",
  "pdf": [
    "https://<servidor>/readonly/exportPdf/MTIzfDl8NnxDTElFTlRFIEVKRU1QTE8..."
  ],
  "details": {
    "numero_comprobante": "20260700000012",
    "numero_control": "00-00000070",
    "tipo_documento": "IVA",
    "periodo": "202607"
  }
}
ClaveDescripción
successtrue.
messageConfirmación; menciona el tipo (IVA o ISLR).
pdfEnlace al PDF del comprobante con estado anulado.
detailsEco de los datos recibidos y el período (AAAAMM) extraído del número de comprobante.

Errores ​

HTTPMensaje (ejemplo)Causa
401Token inválido o ausente.Falta el encabezado Authorization o no tiene la forma Bearer <token>.
401Usuario no autorizado.Token inválido o expirado. Ver Errores.
400El comercio indicado no existe.El token no corresponde a un negocio.
400Cuerpo JSON vacío.No se envió cuerpo.
400El JSON enviado es inválido o está mal formado.Cuerpo mal formado.
400Los campos numero_comprobante, numero_control y tipo_documento son obligatorios.Falta alguno de los tres campos o está vacío.
400El campo tipo_documento debe ser "IVA" o "ISLR".Tipo no reconocido.
400El formato del numero_comprobante es inválido.Menos de 7 caracteres alfanuméricos.
404La retención especificada no existe, los datos no coinciden, o no pertenece a su comercio.No hay un comprobante de ese tipo con ese correlativo y ese número de control en el negocio.
400El período del número de comprobante no coincide con la fecha de asignación de la retención.Los 6 primeros dígitos (AAAAMM) no coinciden con el período del comprobante.
400La retención ya se encuentra anulada.El comprobante ya estaba anulado.
500Error al intentar anular la retención en la base de datos.Error interno al guardar.

Notas ​

  • Cómo se identifica el comprobante. Los 6 primeros caracteres de numero_comprobante son el período y el resto es el correlativo; ambos, junto con numero_control y tipo_documento, deben coincidir con un comprobante del negocio.
  • Irreversible desde el API. No existe un endpoint para revertir la anulación. El número de control usado no se libera.
  • No idempotente. Una segunda anulación del mismo comprobante responde 400 con La retención ya se encuentra anulada.
  • Tras anular, el comprobante aparece con status: "Anulada" en Consultar retenciones de IVA o de ISLR.
  • A diferencia de la emisión, aquí pdf es un arreglo plano de enlaces (no un arreglo de arreglos).

API de Facturación · CG Imprenta Digital