Esta página está orientada a usuarios de negocio y operaciones. Los detalles técnicos están en docs/ERP_INTEGRATION.md.
Comportamiento por defecto: En instalaciones nuevas los pedidos no se escriben automáticamente en el ERP. Los trabajos quedan en «revisión manual»; descargue CSV e impórtelo. El envío automático, el modo seguro y el agente local opcional se activan después.
Flujo general
- En Dashboard → Integraciones contables cree Logo o Mikro, actívelo y elija el modo de escritura segura (por defecto: solo CSV manual).
- En Dashboard → Mapeos de productos ERP complete SKU → código de stock, unidad e IVA.
- Los clientes deben tener código cari o NIF/tax ID; al crear el pedido el trabajo entra en la cola ERP.
- Descargue CSV desde la cola o el detalle del pedido e impórtelo. Active el envío automático solo cuando el proceso sea estable.
Rutas: /dashboard/accounting · /dashboard/integration-mapping?provider=logo o provider=mikro · /dashboard/integration-outbox.
Preparación común
Aclare en el ERP
- Cómo se crean los pedidos: CSV manual, carpeta de importación, procedimiento / agente local.
- Si los SKU de Convord coinciden con el ERP (o usa tabla de mapeo).
- Cómo se resuelve el cliente en el ERP (<strong>código cari</strong> preferido; si no, tax ID).
SKU de productos y variantes en Convord
Rellene el SKU de cada producto. Con gramajes/variantes, cada variante debe tener su SKU.
Panel de mapeo
Gestione el conjunto de mapeo activo en Mapeos de productos ERP. El CSV de la cola requiere snapshot de mapeo.
Escritura segura y automatización
Modo de escritura segura: solo CSV, solo carpeta de importación o solo procedimiento. El envío automático está desactivado por defecto.
Logo — perspectiva de usuario
Convord escribe primero en la cola outbox. La prueba REST clásica de Logo no se usa; el push REST directo está desactivado en producción.
En el panel
- Integraciones contables → Logo → Configuración.
- Opcionalmente endpoint/API key del puente; active el modo seguro y marque la integración como Activa.
- Complete el mapeo SKU en Mapeos ERP (
provider=logo).
- Pedido de prueba → CSV desde la cola o el detalle.
Mikro — perspectiva de usuario
Modelo habitual: dejar CSV en una carpeta de importación. Alternativa: bridge para datos maestros y agente local opcional.
En el panel
- Integraciones contables → Mikro → Ajustes.
- Elija transporte: archivo (ruta + prefijo) o bridge (URL).
- En modo archivo configure la ruta escribible y Probar conexión; en bridge use health check y sync.
- Panel de mapeo (
provider=mikro) + pedido de prueba → cola / CSV.
CSV manual (inicio recomendado)
Ruta por defecto y de respaldo:
- Descargue CSV desde la cola ERP (se requiere snapshot de mapeo).
- Alternativa: CSV Logo/Mikro desde el detalle del pedido (
/dashboard/orders/{id}/erp-manual-export/logo o .../mikro).
- Las columnas de nombre (PRODUCT_NAME / UrunAdi) facilitan la verificación en Excel.
Columnas Logo: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
Columnas Mikro: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
Formato: UTF-8 (BOM), delimitador ;.
Lista de comprobación (resumen)
| Paso | Logo | Mikro |
|---|
| Registro de integración + Activo + modo seguro | Sí | Sí |
| SKU de producto/variante rellenados | Sí | Sí |
| Mapeos ERP (SKU + unidad/IVA) | Sí | Sí |
| Código cari o tax ID del cliente | Sí | Sí |
| Pedido de prueba → cola → CSV | Sí | Sí |
| Ruta de importación / bridge o agente | Opcional | Sí |