Ó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 pagadas más recientes. 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 importan automáticamente las órdenes pagadas de todas las empresas conectadas. Importar hace lo mismo al instante: trae las últimas 50 órdenes pagadas y actualiza las que ya existían.
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 existe, lo crea con nombre, teléfono y correo de MercadoLibre. Si el comprador no trae documento, se crea por nombre.
- Arma la factura con el documento de venta de tu empresa y tu primera forma de pago, una línea por item con el precio unitario que pagó el comprador, y calcula tus impuestos.
- La guarda como cualquier venta (consecutivo, movimientos de inventario, pago) con la referencia igual al número de orden ML. 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 un producto publicado desde Agapanto (el vínculo se hace por el ID de la publicación). Si un item aparece como sin mapear en el detalle, la factura falla con Producto no mapeado para item(s) ML: …. Publica ese producto desde su ficha (Publicar productos) y vuelve a importar la orden.
El total de MercadoLibre puede no coincidir con el de la factura
La factura local aplica tus impuestos configurados, así que puede diferir del total que muestra MercadoLibre. Agapanto deja un registro de auditoría con ambos valores y no bloquea la factura.
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.