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á.

Matriz de control para cómo conectar la recepción de documentos con tu erp

No basta con completar los pasos: cada uno debe dejar una entrada identificada, una comprobación explícita y una evidencia que otra persona pueda revisar sin reconstruir el trámite.

PasoEntrada necesariaControl de excepciónEvidencia de cierre
1. Decide si consultas o escuchas Para cómo conectar la recepción de documentos con tu erp: Acceso al ERP y a quién lo mantiene En cómo conectar la recepción de documentos con tu erp, integrar diez eventos a la vez: Multiplica los fallos sin multiplicar el valor. El cierre de cómo conectar la recepción de documentos con tu erp responde a «¿Con qué ERP se integra?»: Con SAP, NetSuite, Odoo y Drive hay empuje directo al cerrar expediente. Para el resto está la API con SDK de TypeScript.
2. Empieza por un solo evento Para cómo conectar la recepción de documentos con tu erp: Una API key con los permisos mínimos En cómo conectar la recepción de documentos con tu erp, API key con permisos totales: Innecesario en el 90% de los casos. El cierre de cómo conectar la recepción de documentos con tu erp responde a «¿Necesito un desarrollador?»: Para la API sí. Para los conectores de OAuth con Drive o SharePoint, no.
3. Usa una API key con permisos acotados Para cómo conectar la recepción de documentos con tu erp: Saber qué evento del documento le interesa a tu ERP En cómo conectar la recepción de documentos con tu erp, no contemplar el reintento: Los eventos perdidos se descubren tarde y mal. El cierre de cómo conectar la recepción de documentos con tu erp responde a «¿Con qué ERP se integra?»: Con SAP, NetSuite, Odoo y Drive hay empuje directo al cerrar expediente. Para el resto está la API con SDK de TypeScript.
4. Prueba en el entorno de pruebas Para cómo conectar la recepción de documentos con tu erp: Acceso al ERP y a quién lo mantiene En cómo conectar la recepción de documentos con tu erp, integrar diez eventos a la vez: Multiplica los fallos sin multiplicar el valor. El cierre de cómo conectar la recepción de documentos con tu erp responde a «¿Necesito un desarrollador?»: Para la API sí. Para los conectores de OAuth con Drive o SharePoint, no.
5. Contempla el reintento Para cómo conectar la recepción de documentos con tu erp: Una API key con los permisos mínimos En cómo conectar la recepción de documentos con tu erp, API key con permisos totales: Innecesario en el 90% de los casos. El cierre de cómo conectar la recepción de documentos con tu erp responde a «¿Con qué ERP se integra?»: Con SAP, NetSuite, Odoo y Drive hay empuje directo al cerrar expediente. Para el resto está la API con SDK de TypeScript.
6. Documenta la integración para quien venga después Para cómo conectar la recepción de documentos con tu erp: Saber qué evento del documento le interesa a tu ERP En cómo conectar la recepción de documentos con tu erp, no contemplar el reintento: Los eventos perdidos se descubren tarde y mal. El cierre de cómo conectar la recepción de documentos con tu erp responde a «¿Necesito un desarrollador?»: Para la API sí. Para los conectores de OAuth con Drive o SharePoint, no.
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 con SDK de TypeScript.
¿Necesito un desarrollador?
Para la API sí. Para los conectores de OAuth con Drive o SharePoint, no.
Empieza con este caso

Texto listo para copiar y pegar en tu usuario

Completa los campos entre corchetes y pégalo para empezar a configurar el proceso con tu contexto.

Quiero poner en marcha este proceso: Cómo conectar la recepción de documentos con tu ERP.

Mi contexto:
- Empresa o equipo: [indicar]
- Personas o sistemas que aportan información: [indicar]
- Destino final de los datos o documentos: [indicar]
- Frecuencia y fecha límite: [indicar]

Configura conmigo estos pasos:
1. Decide si consultas o escuchas
2. Empieza por un solo evento
3. Usa una API key con permisos acotados
4. Prueba en el entorno de pruebas
5. Contempla el reintento
6. Documenta la integración para quien venga después

Para cada paso, pregúntame qué entra, quién responde, cómo se valida, qué ocurre si falla y qué evidencia queda. No inventes datos que no te haya facilitado.

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

Otros procedimientos