Tools de Melhor Envio
Las 12 operaciones de Melhor Envio que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Calcular envíoPOSTCotiza el envío de productos entre dos CEPs y devuelve una entrada por servicio, con id, transportista, precio, plazo de entrega, los paquetes y un error cuando el servicio no cubre la ruta. custom_price y custom_delivery_time incluyen las tarifas y descuentos de la cuenta. Solo se cotizan los servicios habilitados para la integración en el panel de Melhor Envio.
- Crear ítem en el carritoPOSTAgrega una etiqueta al carrito de la cuenta y la devuelve. Su id es el id de la etiqueta en las demás herramientas. No se paga nada hasta Comprar etiquetas. Correios, J&T y Loggi aceptan un volumen por llamada: para más paquetes, agrega un ítem por paquete.
- Listar ítems del carritoGETLista las etiquetas del carrito que aún no se pagaron, con id, servicio, precio, remitente, destinatario y volúmenes. Las etiquetas permanecen 20 días en el carrito. 10 por página: pasa page para las siguientes, hasta last_page.
- Eliminar ítem del carritoDELETEQuita del carrito una etiqueta que aún no se pagó.
- Comprar etiquetasPOSTPaga etiquetas del carrito con el saldo de la billetera de Melhor Envio y devuelve la compra, con el total y las etiquetas, ya liberadas. La billetera necesita saldo suficiente: compruébalo con Obtener saldo. Las etiquetas pagadas aún necesitan Generar etiquetas.
- Generar etiquetasPOSTGenera etiquetas pagadas, lo que es necesario antes de Imprimir etiquetas, y devuelve el resultado de cada id. Una etiqueta generada debe postarse en un plazo de 20 días, o 7 días con Correios.
- Imprimir etiquetasPOSTDevuelve un enlace para imprimir etiquetas generadas. Un enlace privado se abre solo para quien inició sesión en la cuenta de Melhor Envio; un enlace público se abre para cualquiera que lo tenga.
- Listar etiquetasGETLista las etiquetas de la cuenta con id, protocolo, estado, servicio, precio, código de seguimiento y las fechas de pago, generación, postaje y entrega. 10 por página: pasa page para las siguientes, hasta last_page.
- Obtener etiquetaGETDevuelve una etiqueta con estado, servicio, precio, remitente, destinatario, volúmenes, código de seguimiento y las fechas de pago, generación, postaje y entrega.
- Buscar etiquetasGETEncuentra etiquetas por un valor exacto: el id, el protocolo, el código de seguimiento, el código de autorización, o el CPF o CNPJ del remitente o del destinatario.
- Cancelar etiquetaPOSTCancela una etiqueta. Una etiqueta generada solo puede cancelarse antes de ser postada y antes de que se avise a la transportista de una recolección; el reembolso de una etiqueta generada llega 12 horas después de la aprobación.
- Obtener saldoGETDevuelve el saldo de la billetera de Melhor Envio en BRL, con el monto reservado y las deudas. Comprar etiquetas gasta este saldo.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
