Tres conversaciones que no deben mezclarse
La decisión fiscal sobre una operación no corresponde a la API. El desarrollador implementa datos y reglas acordadas; la gestoría ayuda a definir criterios; la empresa valida que el resultado represente su actividad.
Separar estas preguntas evita convertir un error de datos en una consulta normativa o trasladar una decisión fiscal al proveedor técnico.
Un inventario comprensible
Lista series, tipos de cliente, impuestos, operaciones especiales y documentos relacionados. Añade el volumen y los momentos de mayor carga.
El inventario debe incluir quién puede corregir cada dato y qué sistema conserva la referencia principal.
Prueba conjunta
Selecciona una operación habitual y otra excepcional. El desarrollador observa peticiones y respuestas; administración comprueba la factura; la gestoría revisa el tratamiento aplicado.
Registra las evidencias y las diferencias aceptadas. Una prueba compartida reduce interpretaciones distintas después de la puesta en marcha.
Soporte después del proyecto
Define quién atiende credenciales, cambios de campos, rechazos y modificaciones del software propio. Una integración sin mantenimiento se convierte rápidamente en otra pieza huérfana.
Versiona la especificación y comunica los cambios antes de desplegarlos. Mantén una vía manual o por CSV como contingencia si forma parte del servicio acordado.
Reunión de alcance
- Responsables fiscal, operativo y técnico
- Casos de prueba
- Mapa de datos
- Gestión de credenciales
- Soporte y cambios
- Plan de contingencia
Una integración mantenible para despacho y cliente
Evita que la gestoría dependa de conocer cada detalle técnico. La aplicación del cliente debe conservar referencias comprensibles y el despacho debe poder identificar empresa, serie, factura, fecha y estado cuando comunica una incidencia.
Documenta quién mantiene credenciales, cómo se incorporan nuevas empresas y qué versión del conector está activa. Si el desarrollo original cambia, la frontera de la API permite revisar el intercambio sin reescribir la lógica del registro en cada instalación.
Guía de aplicación paso a paso
Acordad un vocabulario común. Pedido, borrador, factura, registro y asiento contable no significan lo mismo. Definid qué evento representa cada término y quién lo controla. Un glosario breve evita que negocio, despacho y desarrollador validen cosas diferentes con la misma palabra.
Repartid decisiones y ejecución. La gestoría orienta el tratamiento fiscal; el negocio confirma la operación; el desarrollador mantiene el origen y la conexión; VerifacturDocs genera la factura y el registro según el alcance acordado. Documentar este reparto evita dependencias informales.
Normalizad incidencias. Utilizad empresa, referencia, serie, número, fecha y estado en cada comunicación. Añadid el mensaje observado y la acción ya intentada. Esta ficha permite investigar sin intercambiar capturas inconexas ni acceder innecesariamente a todo el sistema del cliente.
Gestionad altas y credenciales. Definid quién solicita una nueva empresa, quién valida sus datos y quién custodia accesos. Separad entornos de prueba y producción. La incorporación de un cliente debe seguir una lista repetible en lugar de depender del desarrollador que recuerda la instalación original.
Mantened versiones y pruebas. Registrad la versión del conector y del contrato de API. Antes de actualizar, repetid un conjunto pequeño de operaciones representativas. Si varios clientes comparten integración, desplegad de forma gradual para detectar una incompatibilidad sin afectar a toda la cartera.
Ejemplo práctico
Una gestoría acompaña a varios clientes con programas sectoriales diferentes. Define con el desarrollador un contrato común de API y un panel de incidencias con referencias entendibles. Cada programa sigue resolviendo su actividad, mientras el registro se delega con el mismo criterio. El despacho puede identificar una factura rechazada sin entrar en el código ni reconstruir manualmente el recorrido de cada cliente.
Antes de cerrar la decisión
Para evitar soporte infinito, crea un conjunto común de pruebas y añade solo los casos sectoriales necesarios. Cada alta debería demostrar factura normal, corrección, rechazo controlado y recuperación. Guarda el resultado junto a la versión instalada para saber qué se validó en cada cliente.
Revisa periódicamente los accesos y responsables. Los cambios de personal en cliente, despacho o desarrollador pueden dejar credenciales sin propietario y procedimientos obsoletos. Una integración mantenible incluye la parte técnica, pero también una lista actual de personas que pueden decidir, operar y escalar.
Al cerrar la implantación, entrega al cliente una ficha con alcance, versión, contactos, procedimiento de incidencia y forma de recuperar datos. La ficha evita que, meses después, una actualización o una consulta dependa de reconstruir conversaciones. Para la gestoría, ofrece además una referencia común que puede incorporar a su proceso de revisión.
Preguntas frecuentes
¿La gestoría debe programar la integración?
No tiene por qué. Debe definir las necesidades operativas y fiscales junto al cliente; el desarrollador implementa el intercambio y documenta sus estados e incidencias.
¿Puede utilizarse el mismo enfoque con varios clientes?
Sí, si se normalizan referencias, estados y campos comunes. Las particularidades de cada actividad siguen necesitando configuración y pruebas específicas.
Fuentes consultadas
Contenido informativo. La aplicación de la norma depende de la situación de cada negocio.