ForHosting KIT · Documentos y PDF

Genere una nota de crédito a partir de una factura

Cree un registro coherente de nota de crédito a partir de la referencia de la factura original, un motivo claro y las líneas exactas que deben revertirse.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

El generador calcula el subtotal y el impuesto de cada línea, suma el abono final y comprueba que el resultado no supere el total de la factura original. La respuesta es JSON estructurado, apto para revisión, archivo, flujos contables o conversión en un documento imprimible con la imagen de su empresa.

Comience con la factura de origen y un motivo preciso

Una nota de crédito útil debe vincularse sin ambigüedad con la operación que corrige. Introduzca la referencia de la factura original exactamente como aparece en su sistema de facturación o contabilidad; indique después el total de esa factura con impuestos incluidos y su código de moneda de tres letras. El motivo debe explicar el hecho comercial y no limitarse a repetir que se emite un abono. Puede tratarse de mercancía devuelta, una reducción de servicio acordada, existencias dañadas, una corrección de precio o un cobro excesivo. Un motivo concreto ofrece a responsables, clientes, contables y auditores el contexto necesario para entender por qué se revierten ingresos e impuestos. El generador conserva ese texto en el documento estructurado, pero no inventa número, fecha de emisión, identidad del cliente, redacción jurídica ni estado de autorización. Esos datos dependen de su organización y jurisdicción, y debe añadirlos el sistema que controla la numeración y emisión. Separar los hechos de origen de los identificadores generados mantiene el cálculo determinista y evita que el documento parezca oficialmente emitido antes de superar su proceso normal de aprobación.

Describa cada línea abonada y deje que se calcule el total

Añada una fila por cada producto, servicio, cargo o ajuste que se vaya a abonar. Cada fila requiere una descripción, una cantidad positiva y un precio unitario no negativo antes de impuestos. El tipo impositivo opcional es un porcentaje y toma el valor cero cuando se omite. Para cada fila, el generador multiplica la cantidad por el precio unitario, redondea el subtotal resultante a dos decimales, calcula el impuesto sobre ese subtotal redondeado y obtiene el total de la línea. Después suma todos los subtotales y todos los impuestos para producir el abono total. El redondeo por línea es deliberado: coincide con la presentación y contabilización de documentos desglosados en muchos sistemas de facturación y garantiza que cada línea visible concilie con el resumen. Utilice valores positivos, pues el tipo de documento ya indica que los importes revierten parte de la factura; cantidades o precios negativos crearían una doble negación confusa. Si la factura original aplicó descuentos o redondeos especiales, represente el importe realmente revertido mediante una línea de ajuste clara para poder conciliar el total generado con la factura de origen.

Valide el resultado antes de emitir el documento final

La respuesta terminada contiene el tipo de documento, la referencia de la factura original, el motivo, la moneda, las líneas numeradas y una sección de totales. Esta muestra el subtotal abonado, el impuesto abonado, el abono total, el total de la factura original y el importe restante después del abono. El generador rechaza la solicitud si el abono calculado supera el total indicado para la factura original. Esta protección evita un error frecuente de introducción de datos, pero no sustituye la comprobación de notas de crédito anteriores vinculadas con la misma factura. Como la herramienta solo recibe la solicitud actual y no utiliza red ni historial almacenado, su sistema de facturación debe verificar el importe acumulado cuando se emitan varios abonos. Antes de aprobar, compare descripciones, cantidades, precios, tratamiento fiscal, moneda y datos del cliente con la factura original. Asigne después el número oficial y la fecha de emisión según sus controles contables y requisitos locales. La respuesta estructurada puede alimentar una plantilla, un libro contable, una cola de aprobación o un generador PDF sin imponer decisiones de presentación o cumplimiento a la fase aritmética.

Abonar mercancía devuelta

Convierta cantidades devueltas, precios originales y tipos impositivos en una nota de crédito desglosada y lista para aprobación.

Corregir un cobro excesivo

Documente un ajuste de precio o cargo y calcule el importe exacto que debe revertirse.

Preparar datos para contabilidad

Cree totales estructurados y coherentes que puedan archivarse, revisarse o enviarse a un generador de documentos corporativos.

¿Cuánto cuesta una solicitud?

Cada solicitud API cuesta $0.002. La versión del navegador se ejecuta localmente sin una solicitud API de pago.

¿Asigna un número oficial de nota de crédito?

No. Prepara los datos calculados, pero deja la numeración oficial y la fecha de emisión en manos de su proceso de facturación controlado.

¿Cómo se calcula el impuesto?

Se calcula por línea a partir del subtotal redondeado y el tipo impositivo; después se suman los impuestos de todas las líneas.

¿Qué ocurre si el abono supera la factura?

La solicitud falla por entrada no válida cuando el abono calculado supera el total indicado de la factura original.

¿Detecta abonos anteriores de la misma factura?

No. No dispone de red ni historial almacenado, por lo que su sistema de facturación debe comprobar los abonos acumulados antes de emitir.

¿Puedo utilizar un tipo impositivo cero?

Sí. Omita tax_rate o establézcalo en cero para una línea que no deba añadir impuestos.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/doc/credit-note-generate

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/doc/credit-note-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"original_invoice_reference":"INV-2026-0042","original_invoice_total":250,"currency":"USD","reason":"Two items were returned unopened.","items":[{"description":"Wireless keyboard","quantity":2,"unit_price":45,"tax_rate":10},{"description":"Shipping adjustment","quantity":1,"unit_price":5}]}'
{
  "original_invoice_reference": "INV-2026-0042",
  "original_invoice_total": 250,
  "currency": "USD",
  "reason": "Two items were returned unopened.",
  "items": [
    {
      "description": "Wireless keyboard",
      "quantity": 2,
      "unit_price": 45,
      "tax_rate": 10
    },
    {
      "description": "Shipping adjustment",
      "quantity": 1,
      "unit_price": 5
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.credit_note_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_items200
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →