Órdenes y facturas¶
Aquí ves las ventas que llegan de MercadoLibre, las conviertes en facturas de Agapanto (una a una, en bloque o automáticamente), revisas el detalle de cada orden y descargas la guía de envío. Está en Menú → MercadoLibre → pestaña Órdenes (ruta /app/mercadolibre?tab=ordenes).
Permiso
ACCESO_MERCADOLIBRE. Las facturas que se crean aquí quedan a nombre del usuario que pulsa Facturar (o del Responsable de las facturas automáticas si es automática).
Un vistazo¶
| Orden | Comprador | Total | Estado | Envío | Factura | Fecha | ||
|---|---|---|---|---|---|---|---|---|
| 2000009876543210 | ANARESTREPO | $12.000 | paid | shipped | Pendiente | 2/9/2026 | visibility request_quote local_shipping chat | |
| 2000009876543211 | MESA4 | $4.720 | paid | ready_to_ship | Pendiente | 2/9/2026 | visibility request_quote local_shipping chat | |
| 2000009876543199 | CARLOSM | $9.440 | paid | delivered | Error 4 | 1/9/2026 | visibility request_quote local_shipping chat | |
| 2000009876543150 | LAURAG | $2.950 | paid | delivered | #1042 | 30/8/2026 | visibility local_shipping chat 5 |
- 1 Filtro Factura (Sin factura / Facturadas) y Buscar orden / comprador.
- 2 Facturar (N): aparece al marcar casillas; factura todas las seleccionadas que aún no tengan factura.
- 3 Importar: pide a MercadoLibre las órdenes de los últimos 30 días, en cualquier estado. Se encola y la tabla se refresca sola unos segundos después.
- 4 Columna Factura: #consecutivo en verde si ya existe, Pendiente si falta, o Error en rojo; pasa el mouse sobre Error para leer el motivo.
- 5 Acciones por fila: Detalle visibility, Generar factura request_quote (solo sin factura), Descargar guía local_shipping (solo con envío) y Mensajes con el comprador chat.
Colores de Estado: verde paid; rojo cancelled / invalid; amarillo los demás (confirmed, payment_required, payment_in_process). Colores de Envío: verde delivered, azul shipped, rojo not_delivered / cancelled, amarillo pending, handling, ready_to_ship; un guion si la orden no tiene envío.
Cómo llegan las órdenes¶
MercadoLibre notifica a Agapanto cada orden nueva o actualizada y cada cambio de envío, así que normalmente no tienes que hacer nada. Como respaldo, cada hora se revisan automáticamente las órdenes recientes de todas las empresas conectadas, canceladas incluidas. Importar hace lo mismo al instante con los últimos 30 días: trae las nuevas y actualiza las que cambiaron.
Facturar una orden¶
Pulsa request_quote Generar factura en la fila. Si todo está bien verás Factura #1043 creada y la columna Factura muestra el consecutivo. Si falla, el aviso rojo explica por qué y el motivo queda guardado bajo la insignia Error.
Marca las casillas y pulsa Facturar (N). Al terminar verás N factura(s) creada(s) o N factura(s) creada(s), M con error; cada orden con error conserva su motivo en la columna Factura. Si todas las seleccionadas ya tenían factura, el aviso dice Las órdenes seleccionadas ya tienen factura.
Activa Crear factura local automáticamente cuando la orden queda pagada en Conectar y elige el responsable. Cada orden que llegue pagada (por notificación o por la importación de cada hora) se factura sola; las que fallen quedan con Error para que las revises.
Qué hace Agapanto al facturar:
- Busca al cliente por el documento del comprador; si no lo encuentra, usa el cliente de una compra anterior del mismo comprador de MercadoLibre, y si tampoco, lo crea con nombre, teléfono y correo.
- Arma la factura con el documento y la forma de pago que elegiste en Conectar (o los de por defecto), una línea por item. El precio de MercadoLibre ya incluye impuestos: Agapanto despeja la base para que el total de la factura sea lo que pagó el comprador.
- La guarda como cualquier venta (consecutivo, movimientos de inventario, pago) y deja una nota Orden MercadoLibre N en la factura. La ves en Ver, pagar y anular una factura.
Solo se facturan órdenes pagadas con todos sus items mapeados
La orden debe estar en estado paid o confirmed y cada item debe corresponder a una publicación vinculada a un producto. Si un item aparece como sin mapear en el detalle, la factura falla con Producto no mapeado para item(s) ML: …. Vincula esa publicación con Vincular existentes (Publicar productos): la orden queda lista para facturar sin volver a importarla.
Una orden, una factura, por el total que pagó el comprador
Aunque la orden llegue a la vez por notificación, por la importación automática y por un clic, se crea una sola factura. El envío de Mercado Envíos no se factura (lo cobra MercadoLibre) y la comisión de MercadoLibre se muestra solo como dato. El redondeo de los impuestos puede dejar una diferencia de uno o dos pesos; cualquier diferencia queda en la pestaña Actividad.
Órdenes canceladas o reembolsadas¶
Si MercadoLibre cancela o reembolsa una orden que ya tenía factura, Agapanto no deshace nada por su cuenta: la orden aparece con la insignia Revisar y en el contador requieren revisión. Al abrirla:
- Marca qué productos volvieron a tu poder. Lo marcado entra al inventario (y de ahí a MercadoLibre). Si la orden no se había despachado, vienen marcados.
- Pulsa Revertir factura. La factura se anula; si es electrónica y la DIAN ya la aceptó, queda una nota crédito en borrador para que la transmitas.
Una orden cancelada que no tenía factura simplemente deja de reservar inventario; no hay nada que revisar.
El detalle de una orden¶
El detalle muestra comprador (nombre, documento, correo y teléfono), total y estado, la lista de Items con el producto local al que corresponde cada uno (o Sin producto local con la insignia sin mapear) y, si hay envío, la línea de tiempo Envío (estado) con cada cambio que notificó MercadoLibre.
Descargar la guía de envío¶
Pulsa local_shipping Descargar guía en la fila: se descarga guia-<número de orden>.pdf listo para imprimir y pegar en el paquete. MercadoLibre solo entrega la etiqueta cuando el envío está listo para despachar; antes verás La guía aún no está disponible (el envío debe estar listo para despachar).
¿Problemas?
- Pulsé Importar y no aparece nada. La importación corre en segundo plano y trae solo órdenes pagadas. Espera unos segundos y recarga; si la cuenta no está conectada el aviso dice MercadoLibre no está conectado.
- La factura falla con "No hay documento de venta configurado" o "No hay forma de pago configurada". Tu empresa necesita un documento de venta marcado como soporte y al menos una forma de pago. Revisa Configurar tu empresa.
- La orden dice "no está pagada". Solo se facturan órdenes
paidoconfirmedcon el pago completo. Espera a que MercadoLibre confirme el pago; la orden se actualizará sola. - Activé la facturación automática pero las órdenes siguen "Pendiente". Falta el Responsable de las facturas automáticas en Conectar, o las órdenes tienen items sin mapear. Abre el detalle para confirmarlo.
Siguiente: Preguntas y mensajes.