Tools Melhor Envio
Les 12 opérations Melhor Envio que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- Calculer l'expéditionPOSTÉtablit un devis d'expédition de produits entre deux CEP et renvoie une entrée par service, avec id, transporteur, prix, délai de livraison, les colis et un error quand le service ne dessert pas le trajet. custom_price et custom_delivery_time incluent les frais et remises du compte. Seuls les services activés pour l'intégration dans le panneau Melhor Envio sont cotés.
- Créer un article du panierPOSTAjoute une étiquette au panier du compte et la renvoie. Son id est l'id de l'étiquette dans les autres outils. Rien n'est payé avant Acheter des étiquettes. Correios, J&T et Loggi acceptent un colis par appel : pour plusieurs colis, ajoutez un article par colis.
- Lister les articles du panierGETListe les étiquettes du panier qui n'ont pas encore été payées, avec id, service, prix, expéditeur, destinataire et colis. Les étiquettes restent 20 jours dans le panier. 10 par page : passez page pour les suivantes, jusqu'à last_page.
- Supprimer un article du panierDELETERetire du panier une étiquette qui n'a pas encore été payée.
- Acheter des étiquettesPOSTPaie des étiquettes du panier avec le solde du portefeuille Melhor Envio et renvoie l'achat, avec le total et les étiquettes, désormais débloquées. Le portefeuille doit avoir un solde suffisant : vérifiez avec Obtenir le solde. Les étiquettes payées doivent encore passer par Générer des étiquettes.
- Générer des étiquettesPOSTGénère des étiquettes payées, ce qui est requis avant Imprimer des étiquettes, et renvoie le résultat pour chaque id. Une étiquette générée doit être déposée sous 20 jours, ou 7 jours avec Correios.
- Imprimer des étiquettesPOSTRenvoie un lien pour imprimer des étiquettes générées. Un lien privé ne s'ouvre que pour quelqu'un connecté au compte Melhor Envio ; un lien public s'ouvre pour toute personne qui l'a.
- Lister les étiquettesGETListe les étiquettes du compte avec id, protocole, statut, service, prix, code de suivi et les dates de paiement, de génération, de dépôt et de livraison. 10 par page : passez page pour les suivantes, jusqu'à last_page.
- Obtenir une étiquetteGETRenvoie une étiquette avec statut, service, prix, expéditeur, destinataire, colis, code de suivi et les dates de paiement, de génération, de dépôt et de livraison.
- Rechercher des étiquettesGETTrouve des étiquettes par une valeur exacte : l'id, le protocole, le code de suivi, le code d'autorisation, ou le CPF ou CNPJ de l'expéditeur ou du destinataire.
- Annuler une étiquettePOSTAnnule une étiquette. Une étiquette générée ne peut être annulée qu'avant son dépôt et avant que le transporteur soit prévenu d'un enlèvement ; le remboursement d'une étiquette générée arrive 12 heures après l'approbation.
- Obtenir le soldeGETRenvoie le solde du portefeuille Melhor Envio en BRL, avec le montant réservé et les dettes. Acheter des étiquettes dépense ce solde.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
