¿Qué permite la API de Defontana?
Defontana publica una API REST con documentación para Chile y un ambiente de prueba separado del de producción. Se autentica con el cliente y la empresa que asigna Defontana, más un usuario y su clave, y entrega un token. Cada token nuevo invalida los anteriores del mismo usuario, así que todos los procesos de la integración deben compartir uno.
Cubre lo que una integración con HubSpot necesita: clientes con RUT, giro y rubro, productos, listas de precios y stock, cotizaciones, pedidos y documentos de venta, incluidas notas de crédito y débito.
¿Qué conviene sincronizar y en qué dirección?
Lo habitual es que HubSpot mande en la etapa comercial y Defontana en la contable. El cliente nace en HubSpot y, al ganar el negocio, se busca por RUT en Defontana y se crea si no existe. Los productos y precios viajan al revés, desde Defontana, para que las cotizaciones de HubSpot usen los mismos códigos que la factura.
El negocio ganado gatilla el pedido o la venta en Defontana con los datos ya validados. De vuelta, la factura actualiza el negocio y la empresa en HubSpot con el folio, la fecha, el monto y el estado ante el SII. Escribe estas reglas antes de programar: es lo que evita duplicados.
¿Qué cuidar con la factura electrónica?
La emite Defontana: en los documentos electrónicos, la API asigna el folio automáticamente desde los folios autorizados de la empresa y permite consultar el estado del documento ante el SII. HubSpot tiene facturas propias, pero no son documentos tributarios electrónicos; solo muestra lo que emitió el ERP.
Los errores típicos son de datos: RUT mal escrito, giro vacío, dirección tributaria incompleta, productos sin código en Defontana o condiciones de pago distintas. Valida esos campos en HubSpot antes de ganar el negocio y prueba primero en el ambiente de prueba, con documentos reales de tu operación en Chile.
¿Cómo saber que la integración sigue funcionando?
Como Defontana no avisa con webhooks, la integración consulta cada cierto tiempo y deja un rastro. En HubSpot, la propiedad Fuente del registro muestra qué registros creó la integración, y la aplicación guarda el registro de sus llamadas. Un informe diario por fuente muestra si las facturas siguen llegando.
Define una alerta de silencio: si en un día hábil no llega ninguna factura, alguien recibe un aviso esa misma mañana. Y deja un dueño con acceso al código, a las credenciales de Defontana y a la documentación. En empresas de Chile y Latinoamérica, una factura que no llega al CRM suele descubrirse cuando cobranza llama al vendedor equivocado.