La API española para facturar con VeriFactu desde tu software.

Necesito conectar mi software con la API REST de Beply.

📚 Documentación oficial: https://beply.es/help/desarrolladores
🔍 Listado de recursos: GET https://<tu-instancia>.beply.es/api/3

CONVENCIONES OBLIGATORIAS:
- URL base: https://<tu-instancia>.beply.es/api/3/
- Autenticación: cabecera "Token: <api-key>" (NO Bearer, NO Authorization)
- POST/PUT en application/x-www-form-urlencoded (NO JSON en el body)
- La respuesta es siempre application/json
- Nombres de campos en español: codcliente, nombre, pvpunitario, dtopor, codimpuesto...
- Fechas: envío en YYYY-MM-DD, respuesta en DD-MM-YYYY

TIPOS DE ENDPOINTS:
1) Recursos REST (minúsculas, CRUD genérico):
   GET    /api/3/<recurso>            → listar (soporta filter[col]=val, sort, limit, offset)
   GET    /api/3/<recurso>/<id>       → obtener uno
   POST   /api/3/<recurso>            → crear (form-urlencoded)
   PUT    /api/3/<recurso>/<id>       → actualizar parcial
   DELETE /api/3/<recurso>/<id>       → eliminar
   GET    /api/3/<recurso>/schema     → ver campos disponibles

   Ejemplos de recursos: clientes, productos, proveedores, facturaclientes,
   albaranclientes, pedidoclientes, presupuestoclientes, pagoclientes, asientos,
   almacenes, stocks, beplyocreventes (OCR de facturas), agentes, impuestos.

2) Funciones (camelCase, flujos completos en una llamada):
   POST /api/3/crearFacturaCliente               → factura con líneas + VeriFactu auto
   POST /api/3/pagarFacturaCliente/<idfactura>   → marcar pagada
   POST /api/3/crearFacturaRectificativaCliente  → rectificativa
   GET  /api/3/exportarFacturaCliente/<id>?type=PDF → PDF binario
   POST /api/3/uploadFiles                       → subir archivo (multipart/form-data)
   POST /api/3/attachedfilerelations             → vincular archivo a registro

FORMATO DE RESPUESTA:
- POST genérico: { "ok": "Registro actualizado correctamente.", "data": { ... } }
- crearFacturaCliente y similares: { "doc": { ... }, "lines": [ ... ] }
- Errores:
   401 → { "status": "error", "message": "Clave de API no válida" }
   404 → { "error": "Registro no encontrado" }
   400 (validación) → { "error": "<mensaje>", "data": { ... } }

VeriFactu/TicketBAI/SII se aplican automáticamente al crear facturas según el
domicilio fiscal de la cuenta. Hash, encadenado, QR y envío a la AEAT son
transparentes para el integrador.

---
Mi tarea:
[Aquí dile a tu IA QUÉ quieres construir. Ej:
"Quiero que cuando Stripe me notifique un pago de suscripción, mi backend
emita una factura en Beply con VeriFactu para ese cliente. Escríbeme el
código en Node.js con manejo de errores."]