Cómo integrar el API SEPA en Node.js

Cómo integrar el API SEPA en Node.js

Cómo consumir el API de Conversor SEPA desde Node.js con fetch o axios, paso a paso.

TL;DR

• Tiempo estimado: 5-15 minutos según el tamaño del fichero.
• Herramienta: Conversor SEPA.
• Resultado: un fichero SEPA XML listo para tu banco.

Antes de empezar

Necesitas:

• Un fichero de origen (Norma, CSV, Excel o JSON).
• Tu Identificador de Acreedor (CID). Si no lo tienes, calcúlalo en Identificador SEPA.
• Acceso a la banca online de tu banco.

Pasos

1. Obtén tu API key — Desde el panel de Conversor SEPA, copia tu token personal.
2. Llama al endpoint /api/v1/sepa/direct_debits — Envía un POST con tus operaciones en JSON.
3. Recibe el XML — La respuesta es un pain.008 listo para firmar y enviar al banco.
4. Maneja errores — Cualquier respuesta 4xx incluye un campo errors con los IBANs/operaciones problemáticas.

Validación obligatoria

Antes de enviar el fichero al banco, valida siempre con nuestro Validador SEPA XML. El 80 % de las devoluciones se evitan en este paso.

Errores comunes

• IBAN del deudor con dígito de control erróneo → AC01.
• Mandato sin firmar o fecha incorrecta → MD01.
• Concepto con caracteres no ASCII → puede rechazarlo el banco.

Conclusión

Sigue estos pasos y tendrás tu remesa SEPA enviada en menos de 10 minutos. Si te bloqueas, escríbenos desde la web.