Integraciones

Cómo conectar la recepción de documentos con tu ERP

API, webhooks y el empuje al cerrar expediente. Cuál usar en cada caso.

6 pasos· 2 horas para la primera integración· Industria

Interfaz de Code Contract para coordinar documentos y datos
Vista de la plataforma: el proceso coordina documentos y datos hasta el expediente correcto.

Antes de empezar necesitas

  • Acceso al ERP y a quién lo mantiene
  • Una API key con los permisos mínimos
  • Saber qué evento del documento le interesa a tu ERP
  1. Decide si consultas o escuchas

    Si tu ERP necesita saber algo en cuanto pasa, webhook. Si le basta con mirar de vez en cuando, API. Preguntar cada cinco minutos por si acaso es el peor de los dos mundos.

  2. Empieza por un solo evento

    «Documento validado» suele ser el que más valor da. Integrar los diez de golpe multiplica los puntos de fallo sin multiplicar el beneficio.

  3. Usa una API key con permisos acotados

    De solo lectura si solo va a leer. Es la diferencia entre un incidente y una catástrofe.

  4. Prueba en el entorno de pruebas

    Hay sandbox por organización precisamente para no ensuciar datos reales mientras se integra.

  5. Contempla el reintento

    Si tu ERP está caído cuando llega el webhook, tiene que poder recuperarse. Un evento perdido en silencio es peor que un error visible.

  6. Documenta la integración para quien venga después

    Quién la hizo, qué evento escucha y qué hace con él. En dos años nadie se acordará.

Las pantallas cambian, el trámite no Los sistemas oficiales cambian de interfaz sin avisar, así que un botón puede estar en otro sitio del que aquí se dice. Lo que no cambia es el fondo: qué datos hacen falta, qué tiene que cuadrar con qué y qué se comprueba al otro lado.

Los errores que más lo devuelven

Integrar diez eventos a la vez

Multiplica los fallos sin multiplicar el valor.

API key con permisos totales

Innecesario en el 90% de los casos.

No contemplar el reintento

Los eventos perdidos se descubren tarde y mal.

Preguntas frecuentes

¿Con qué ERP se integra?
Con SAP, NetSuite, Odoo y Drive hay empuje directo al cerrar expediente. Para el resto está la API v1 con SDK de TypeScript.
¿Necesito un desarrollador?
Para la API sí. Para los conectores de OAuth con Drive o SharePoint, no.

Procedimiento revisado el . Las normas cambian: si el sistema oficial no se parece a lo que lees aquí, manda la pantalla del sistema.

Esto no es asesoramiento jurídico ni aduanero Es un procedimiento operativo. Para tu caso concreto, y sobre todo si hay una partida en juego, consúltalo con tu transitario o tu asesor.

Cuando cambie algo de este trámite, te avisamos

Una vez al mes: qué obligación entra en vigor, a quién afecta y qué hay que empezar a pedir. Nada más.

Y si lo que quieres es que esto ocurra solo

Pedir el documento, insistir por el canal que el otro sí contesta, leerlo, comprobar que cuadra y dejarlo demostrable: es exactamente lo que hace Code Contract. Sin que la otra parte se registre en nada.

Programar una demo de 30 minutos