forumAbrir tema

Nos dijeron "haremos una integración por API" — ¿cómo es el proceso y qué nos van a pedir?

NNuri N***ParticipanteMiembro de la comunidad
Miembro desde
nov 2023
Mensaje
4
#1

En nuestra e-commerce recibimos una media de 60-70 pedidos al día. Hasta ahora un empleado metía a mano todas las tardes las facturas y movimientos de stock en el programa contable. Hemos contratado a un equipo externo para automatizar la sincronización de pedidos clientes y stock. o sea nos dieron 45.000 TL de presupuesto y 3 semanas de plazo.

En la primera reunión nos dijeron: "preparad los endpoints de la API del otro lado y el entorno de pruebas, del resto nos encargamos". Pero no somos una empresa técnica. Al llamar al proveedor del programa contable nos pidieron 12.000 TL extra por subir la licencia a API y solo nos mandaron un enlace con documentación.

¿En la práctica qué etapas tiene este proceso de integración por API? bueno ¿Qué accesos, cuentas y datos debemos facilitar nosotros para que no se atranque? ¿Veis realista el plazo de 3 semanas?

RRecep T***Nuevo miembro
Cargo
Representante de ventas de campo
Sector
Logística
Tipo de organización
empresa dentro de un holding
Miembro desde
ago 2026
Mensaje
39

Doki · Configuración de copias de seguridad · 2023

Más útil#2

Respuesta corta: Una integración API consiste en hacer que tu web y tu software contable intercambien datos de forma automática bajo unas reglas prefijadas. Para avanzar, debes habilitar la licencia API de tu programa contable, enviar la documentación de desarrollador al programador y facilitar un entorno de pruebas sin tocar datos reales.

El proceso pasa por cuatro fases estándar. La primera es el mapeo de datos; se emparejan los campos de la web (nombre de cliente, NIF/CIF, código de producto, tipo de IVA, envío) con los del programa contable. La segunda es el desarrollo e integración en entorno de pruebas (sandbox), donde el dev crea pedidos ficticios para probar el traspaso.

En la tercera fase se prueban casos de error: qué pasa si un pedido no lleva DNI, cómo se reflejan los cupones de descuento, o cómo se cierran las cancelaciones y devoluciones en contabilidad. En la cuarta fase se introducen las claves API reales, se pasa a producción con pedidos verdaderos y se monitoriza de cerca los primeros días.

A vosotros os pedirán tres cosas básicas: 1) Claves API y documentación del desarrollador facilitadas por la empresa contable, 2) Acceso a la base de datos de pruebas, 3) Vuestra confirmación por escrito de la lógica de negocio (momento de facturar, gestión de stock, reglas de descuento). Si la parte contable entrega la documentación técnica completa, 3 semanas es muy razonable; si su soporte es lento, puede irse a 5 semanas.

UUfuk S***Participante
Cargo
Contabilidad básica
Sector
Agricultura
Tipo de organización
cooperativa
Miembro desde
jun 2022
Mensaje
74

Doki · Soporte de respuesta a incidentes · 2025

#3

El error más típico es que no coincidan los códigos de producto. Si los códigos de stock de la web no son idénticos a los de contabilidad, la integración falla desde el día uno. Antes de entregar el trabajo al dev, revisa tú mismo en un Excel que todos los SKU coincidan con los del programa contable.

CCanParticipante
Cargo
Experto en SEO
Miembro desde
mar 2024
Mensaje
172
#4

Dejad firmado por escrito si la integración será unidireccional o bidireccional. ¿Solo se enviarán pedidos de la web a contabilidad, o los cambios de stock y precio en contabilidad deben actualizarse en la web? En bidireccional entran en juego los límites de peticiones API y la gestión de conflictos, lo que alarga bastante el desarrollo.

KKader U***Participante
Cargo
Empleado de tienda
Sector
Medios y publicación
Tipo de organización
empresa familiar
Miembro desde
jun 2024
Mensaje
86
#5

El año pasado hicimos una integración parecida. Tardamos 9 días enteros solo en conseguir la licencia API y las claves de prueba de la empresa contable. El equipo dev terminó el código en 12 días, pero las pruebas se alargaron 8 días por descuadres con las líneas de envío y descuentos. En total tardamos 29 días en salir a producción.

OOrhan T***ParticipanteMiembro de la comunidad
Miembro desde
mar 2024
Mensaje
242
#6

La lista de tareas para vuestra parte debe ser: 1) Solicitar entorno de pruebas (sandbox) y documentación al proveedor contable. 2) Aclarar con la asesoría fiscal cómo gestionar cancelaciones, devoluciones y entregas parciales, dejando las reglas por escrito. 3) Generar al menos 15 facturas de prueba con distintos escenarios antes de pasar a producción.

YYaseminParticipante
Cargo
Propietario de pyme
Miembro desde
jul 2024
Mensaje
98
#7

¿Su programa de contabilidad es en la nube o está instalado en un servidor local en su propia oficina? Si corre en un ordenador de la oficina, necesitarán una IP fija y abrir puertos en el servidor. Eso puede crear fallos de seguridad y además, si se corta el internet de la oficina, la integración se detiene; ¿han hablado sobre esto?

TTaner E***Participante
Cargo
Responsable de compras
Sector
cuero
Tipo de organización
startup recién creada
Miembro desde
jun 2023
Mensaje
132
#8

al principio nuestro contable nos daba error con las facturas de clientes extranjeros q no tienen número de identidad. si reciben pedidos del extranjero o emiten facturas corporativas, hablen desde ya cómo se van a mapear esos campos porque si no los pedidos se quedan colgados en el sistema.

edit: arriba escribí mal, disculpad.

SSinemExperto
Cargo
Gestor de proyectos
Miembro desde
oct 2023
Mensaje
176
#9

Junten al equipo de desarrollo y al soporte técnico de su programa de contabilidad en un grupo de correo o canal de comunicación común. Ustedes no tienen por qué entender los términos técnicos ni hacer de puente. Dejen que las personas técnicas resuelvan directamente entre ellas los parámetros y los endpoints.

VVahide K***Participante
Cargo
Diseñador gráfico
Sector
Energía
Tipo de organización
Empresa de 120 empleados
Miembro desde
nov 2023
Mensaje
411
#10

En nuestra primera integración no quisimos pagar 12.000 TL por el entorno de pruebas y testeamos directamente en la base de datos de producción. Cuando el programador emitió una factura de prueba, le llegó una e-arşiv fatura y notificaciones por SMS a un cliente real. Ese día entendimos clarísimo que el dinero invertido en el entorno de pruebas es, en realidad, el seguro más barato.

OOnur M***Experto
Cargo
Contable
Sector
Plástico
Tipo de organización
mediana empresa
Miembro desde
may 2023
Mensaje
7
#11

Guardado.

HHüseyin S***VeteranoMiembro de la comunidad
Miembro desde
jul 2022
Mensaje
175
#12

La respuesta de arriba ha dado en el clavo. Lo importante no es la cifra, sino en qué se basa esa cifra.

Las decisiones apresuradas son las que hay que corregir seis meses después. También me gustaría saber si alguien lo hace de otra manera.

İİbrahim Y***ParticipanteMiembro de la comunidad
Miembro desde
dic 2024
Mensaje
182
#13

Hay algo que no entiendo. Si la propiedad del código no está en el contrato, al irte no tienes poder de negociación.

También me gustaría saber si alguien lo hace de otra manera.

HHilal B***Veterano
Cargo
Diseñador gráfico
Sector
Electricidad-electrónica
Tipo de organización
distribuidor regional
Miembro desde
dic 2023
Mensaje
17
#14

Voy a contar mi experiencia. Las credenciales de acceso deben crearse a nombre de la empresa, no con cuentas personales.

Lo dejo como nota, por si sirve.

İİbrahim Y***ParticipanteMiembro de la comunidad
Miembro desde
feb 2026
Mensaje
3
#15

estoy de acuerdo.

EElifParticipante
Cargo
Propietario de cadena de cafeterías
Tipo de organización
Empresa de producción de 40 empleados
Miembro desde
ago 2024
Mensaje
63

Doki · Soporte de respuesta a incidentes · 2024

#16

No te olvides de: La oferta más barata suele ser la menos pensada.

Yo seguiría por ese camino.

HHavva K***ParticipanteMiembro de la comunidad
Miembro desde
jul 2024
Mensaje
111
#17

El camino que parece barato suele salir caro a la larga. Las credenciales de acceso deben crearse a nombre de la empresa, no con cuentas personales.

Lo que más tiempo nos hacía perder era no saber quién tomaba las decisiones. Si tenéis dudas, escribid, os responderé en la medida de lo posible.

MMehmet A***Experto
Cargo
Desarrollador de software
Sector
Formación
Tipo de organización
Empresa de 300 empleados
Miembro desde
jul 2022
Mensaje
2
#18

Dejo una advertencia. Todo lo que no está por escrito, ambas partes lo recordarán de forma distinta en el futuro.

Yo seguiría por ese camino.

KKübra G***Experto
Cargo
Director de TI
Sector
Deportes y fitness
Tipo de organización
Empresa de 20 empleados
Miembro desde
nov 2025
Mensaje
10
#19

Me pasó lo mismo. Un informe semanal por escrito funciona mucho mejor que preguntar por fechas.

Empezad con una pequeña prueba, no lo integréis todo de golpe. Ánimo.

OOsman K***ParticipanteMiembro de la comunidad
Miembro desde
mar 2024
Mensaje
117
#20

Gracias por escribir esto, es lo correcto. Las decisiones apresuradas son las que hay que corregir seis meses después.

No tengáis miedo de preguntar, quien no pregunta siempre paga más caro. Eso es todo, disculpa si me he extendido demasiado.

Responder