GuiStracini.Mandae
7.1.17
See the version list below for details.
Requires NuGet 2.12 or higher.
dotnet add package GuiStracini.Mandae --version 7.1.17
NuGet\Install-Package GuiStracini.Mandae -Version 7.1.17
<PackageReference Include="GuiStracini.Mandae" Version="7.1.17" />
paket add GuiStracini.Mandae --version 7.1.17
#r "nuget: GuiStracini.Mandae, 7.1.17"
// Install GuiStracini.Mandae as a Cake Addin #addin nuget:?package=GuiStracini.Mandae&version=7.1.17 // Install GuiStracini.Mandae as a Cake Tool #tool nuget:?package=GuiStracini.Mandae&version=7.1.17
Mandaê SDK
The (unofficial) Mandaê API client for .NET projects.
Para a versão em português, por favor siga me.
This is an unnoficial client for the Mandaê API V2
CI/CD
Build status | Last commit | Tests | Coverage | Code Smells | LoC |
---|---|---|---|---|---|
Code Quality (main branch)
Installation
Github Releases
Download the latest zip file from the Release page.
Nuget package manager
Package | Version | Downloads |
---|---|---|
GuiStracini.Mandae |
Features
This client supports the following operations/features of the API:
- Get rates for a delivery (postal code and package dimensions)
- Schedule a collect (register a collect in the customer distribution center with one or more packages. Each package can have one or more items/skus)
- Get tracking data of a shipment (Get all tracking data available from one package - tracking code is set by the customer or provided by webhook)
- WebHooks schema ready (The web hooks models, ready for implementation)
- Experimental Querying orders (API V1 - non-public API)
- Experimental Querying ocurrences (API V1 - non-public API). Issue #1
- Experimental Querying reverses (API V1 - non-public API). Issue #2
- Experimental Request reverse (API V1 - non-public API). Issue #3
Usage
Setup the MandaeClient
Initializes a new instance of MandaeClient class.
Example:
//Request your API token to ti@mandae.com.br
//Each environment has it's own API token!
var apiToken = "my API token";
//Call the constructor with the API token and de API environment (SANDBOX | PRODUCTION).
//var client = new MandaeClient(apiToken); //<= Environment.SANDBOX is the default environment.
var client = new MandaeClient(apiToken, Environment.PRODUCTION);
Get rates for a package/delivery
Get the rates (Rápido & Econômico) values and delivery time for a specified postal code and package dimensions.
Example:
//The MandaeClient
var client = new MandaeClient("my API token");
//The RatesModel
var delivery = new RatesModel {
PostalCode = "22041080",
...
}
var rates = client.GetRates(delivery);
var fast = rates.ShippingServices.Single(s => s.Name == "Rápido");
var economic = rates.ShippingServices.Single(s => s.Name == "Econômico");
var option = ShippingService.ECONOMICO;
if(fast.Price < economic.Price)
option = ShippingService.RAPIDO;
//The OrderModel (order collect request model)
var order = new OrderModel { ... };
order.Items = new [] {
new NewItem
{
....
ShippingService = option
}
};
var order = client.RegisterOrderCollectRequest(order);
Schedule a collect request
Schedule a collect request (pickup in distribution center / origin location).
Inform which type of Vehicle, when, which rate (Rapido | Economico) and the order items (a.k.a packages or clients orders).
Each package means a order/volume, that can have one or more items (SKUs).
Example:
//The MandaeClient
var client = new MandaeClient("my API token");
//The OrderModel (order collect request model)
var order = new OrderModel { ... };
order.Items = new [] {
new NewItem
{
....
ShippingService = option
}
};
//Makes the request
var order = client.RegisterOrderCollectRequest(order);
//order.Id is the id for futher use (maybe cancel the request ?)
Get tracking of a package
Example:
//The MandaeClient
var client = new MandaeClient("my API token");
//The tracking identifier (Generate by the Mandae or sent by the order collect request
var trackingId = "MyCompany-00001";
var tracking = client.GetTracking(trackingId);
//tracking.CarrierName;
//tracking.CarrierCode;
//tracking.Events;
Querying orders (API V1 - Search) EXPERIMENTAL/NON-PUBLIC API
For the V1 you'll need to use the e-mail/password combination of t he Mandaê painel to login in V1 API.
Example:
//The MandaeClient
var client = new MandaeClient("V2 API token");
client.ConfigureV1Authentication("myEmail@example.com", "mypassword");
var trackingCode = "XYZ000001";//The tracking code of some order
var result = client.Search(SearchMethod.TRACKING_CODE, trackingCode);
if(result.Total == 1)
Console.WriteLine(result.Orders.Single().SituationDescription);
Release notes
- Release v6.0.0 and higher DEPRECATED methods: Get Latest Order
- Release v5.0.0 and higher DEPRECATED methods: Large Request, Cancel Request, Cancel Item Request
- Release v3.0.0 and higher changes the V1 authentication method. Now use your e-mail/password of the Mandaê painel to login in the V1 API.
- Release v1.4.1 and higher also includes a experimental (non-public) V1 endpoint for search/querying orders (the same interface as available through the Mandaê administration panel).
The API V1 is not officially public, so there is no warranty that it will still working
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net47 is compatible. net471 was computed. net472 was computed. net48 is compatible. net481 was computed. |
-
.NETFramework 4.8
- GuiStracini.SDKBuilder (>= 3.0.133)
- Microsoft.AspNet.WebApi.Client (>= 5.2.9)
- Newtonsoft.Json (>= 13.0.3)
- System.Runtime.CompilerServices.Unsafe (>= 6.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
8.0.672 | 67 | 10/28/2024 |
8.0.666 | 81 | 10/21/2024 |
8.0.663 | 104 | 10/14/2024 |
8.0.660 | 85 | 10/2/2024 |
8.0.657 | 78 | 10/2/2024 |
8.0.652 | 81 | 9/23/2024 |
8.0.649 | 90 | 9/23/2024 |
8.0.643 | 120 | 9/16/2024 |
8.0.640 | 99 | 9/10/2024 |
8.0.629 | 105 | 9/3/2024 |
8.0.623 | 85 | 8/29/2024 |
8.0.616 | 85 | 8/29/2024 |
8.0.613 | 96 | 8/29/2024 |
8.0.606 | 86 | 8/28/2024 |
8.0.599 | 95 | 8/27/2024 |
8.0.594 | 100 | 8/26/2024 |
8.0.591 | 91 | 8/26/2024 |
8.0.586 | 91 | 8/26/2024 |
8.0.581 | 87 | 8/26/2024 |
8.0.566 | 112 | 8/19/2024 |
8.0.563 | 104 | 8/12/2024 |
8.0.560 | 66 | 7/29/2024 |
8.0.557 | 95 | 7/22/2024 |
8.0.549 | 87 | 7/16/2024 |
8.0.546 | 88 | 7/16/2024 |
8.0.541 | 88 | 7/16/2024 |
8.0.532 | 95 | 7/16/2024 |
8.0.529 | 88 | 7/16/2024 |
8.0.501 | 114 | 6/19/2024 |
8.0.500 | 111 | 6/18/2024 |
8.0.498 | 117 | 6/18/2024 |
8.0.492 | 93 | 6/3/2024 |
8.0.489 | 95 | 6/3/2024 |
8.0.484 | 87 | 5/28/2024 |
8.0.481 | 97 | 5/28/2024 |
8.0.476 | 106 | 5/28/2024 |
8.0.469 | 96 | 5/28/2024 |
8.0.460 | 83 | 5/20/2024 |
8.0.457 | 75 | 5/15/2024 |
8.0.442 | 96 | 4/29/2024 |
8.0.439 | 89 | 4/29/2024 |
8.0.434 | 95 | 4/29/2024 |
8.0.427 | 90 | 4/29/2024 |
8.0.418 | 107 | 4/22/2024 |
8.0.415 | 82 | 4/22/2024 |
8.0.410 | 101 | 4/22/2024 |
8.0.403 | 125 | 4/15/2024 |
8.0.400 | 122 | 4/15/2024 |
8.0.395 | 117 | 4/15/2024 |
8.0.388 | 107 | 4/15/2024 |
8.0.379 | 142 | 4/8/2024 |
8.0.376 | 126 | 4/8/2024 |
8.0.371 | 131 | 4/8/2024 |
8.0.364 | 148 | 4/1/2024 |
8.0.361 | 167 | 3/25/2024 |
8.0.358 | 157 | 3/25/2024 |
8.0.353 | 177 | 3/18/2024 |
8.0.350 | 177 | 3/18/2024 |
8.0.345 | 225 | 3/11/2024 |
8.0.342 | 272 | 2/26/2024 |
8.0.339 | 260 | 2/26/2024 |
8.0.334 | 255 | 2/26/2024 |
8.0.327 | 259 | 2/26/2024 |
8.0.318 | 284 | 2/19/2024 |
8.0.310 | 280 | 2/19/2024 |
8.0.303 | 286 | 2/19/2024 |
8.0.294 | 290 | 2/14/2024 |
8.0.288 | 307 | 2/12/2024 |
8.0.285 | 335 | 2/5/2024 |
8.0.282 | 320 | 2/5/2024 |
8.0.277 | 342 | 1/30/2024 |
8.0.272 | 348 | 1/29/2024 |
8.0.269 | 343 | 1/29/2024 |
8.0.264 | 343 | 1/29/2024 |
8.0.254 | 379 | 1/22/2024 |
8.0.251 | 351 | 1/22/2024 |
8.0.246 | 349 | 1/22/2024 |
8.0.239 | 352 | 1/22/2024 |
8.0.230 | 406 | 1/16/2024 |
8.0.227 | 378 | 1/16/2024 |
8.0.222 | 381 | 1/15/2024 |
8.0.215 | 413 | 1/8/2024 |
8.0.212 | 405 | 1/8/2024 |
8.0.207 | 455 | 12/25/2023 |
8.0.204 | 442 | 12/25/2023 |
8.0.199 | 441 | 12/25/2023 |
8.0.192 | 439 | 12/25/2023 |
8.0.183 | 458 | 12/18/2023 |
8.0.178 | 446 | 12/18/2023 |
8.0.166 | 451 | 12/14/2023 |
8.0.157 | 461 | 12/12/2023 |
8.0.154 | 446 | 12/12/2023 |
8.0.149 | 455 | 12/12/2023 |
8.0.142 | 448 | 12/11/2023 |
8.0.137 | 451 | 12/11/2023 |
8.0.134 | 443 | 12/11/2023 |
8.0.114 | 479 | 12/8/2023 |
8.0.111 | 458 | 12/8/2023 |
8.0.108 | 478 | 12/8/2023 |
8.0.105 | 455 | 12/8/2023 |
8.0.96 | 453 | 12/8/2023 |
8.0.85 | 488 | 12/8/2023 |
8.0.59 | 1,431 | 11/14/2023 |
8.0.54 | 492 | 11/14/2023 |
8.0.49 | 472 | 11/13/2023 |
8.0.44 | 462 | 11/13/2023 |
8.0.37 | 511 | 11/9/2023 |
8.0.32 | 508 | 11/7/2023 |
8.0.27 | 491 | 11/6/2023 |
8.0.24 | 554 | 10/30/2023 |
8.0.21 | 514 | 10/30/2023 |
8.0.18 | 502 | 10/30/2023 |
8.0.13 | 550 | 10/22/2023 |
7.1.346 | 552 | 10/9/2023 |
7.1.343 | 531 | 10/9/2023 |
7.1.338 | 552 | 10/9/2023 |
7.1.335 | 554 | 10/9/2023 |
7.1.330 | 552 | 10/9/2023 |
7.1.323 | 559 | 10/7/2023 |
7.1.313 | 570 | 9/25/2023 |
7.1.308 | 574 | 9/24/2023 |
7.1.305 | 565 | 9/24/2023 |
7.1.298 | 573 | 9/23/2023 |
7.1.294 | 604 | 9/13/2023 |
7.1.287 | 611 | 9/13/2023 |
7.1.284 | 584 | 9/12/2023 |
7.1.281 | 582 | 9/12/2023 |
7.1.271 | 755 | 8/28/2023 |
7.1.263 | 821 | 8/14/2023 |
7.1.260 | 662 | 8/13/2023 |
7.1.227 | 660 | 8/13/2023 |
7.1.220 | 878 | 7/29/2023 |
7.1.218 | 734 | 7/29/2023 |
7.1.204 | 724 | 7/28/2023 |
7.1.200 | 749 | 7/25/2023 |
7.1.197 | 749 | 7/25/2023 |
7.1.190 | 799 | 7/19/2023 |
7.1.182 | 708 | 7/19/2023 |
7.1.157 | 948 | 6/27/2023 |
7.1.150 | 747 | 6/26/2023 |
7.1.145 | 836 | 6/19/2023 |
7.1.138 | 775 | 6/19/2023 |
7.1.135 | 742 | 6/19/2023 |
7.1.126 | 735 | 6/18/2023 |
7.1.107 | 911 | 6/6/2023 |
7.1.104 | 753 | 6/6/2023 |
7.1.95 | 748 | 6/6/2023 |
7.1.75 | 802 | 6/5/2023 |
7.1.17 | 1,167 | 5/4/2023 |
7.1.16 | 736 | 5/2/2023 |
7.1.15 | 812 | 4/28/2023 |
7.1.10 | 775 | 4/21/2023 |
7.1.8 | 791 | 4/21/2023 |
7.1.2 | 956 | 4/10/2023 |
7.0.101 | 778 | 4/8/2023 |
7.0.97 | 819 | 4/4/2023 |
7.0.92 | 914 | 4/3/2023 |
7.0.86 | 836 | 4/3/2023 |
7.0.64 | 888 | 3/26/2023 |
7.0.59 | 829 | 3/26/2023 |
7.0.43 | 845 | 3/22/2023 |
7.0.36 | 938 | 2/4/2023 |
7.0.31 | 1,004 | 1/24/2023 |
7.0.28 | 902 | 1/24/2023 |
7.0.25 | 909 | 1/24/2023 |
7.0.13 | 895 | 1/23/2023 |
7.0.8 | 864 | 1/23/2023 |
6.0.46 | 1,172 | 1/16/2023 |
6.0.43 | 923 | 1/16/2023 |
6.0.31 | 923 | 1/9/2023 |
6.0.30 | 940 | 12/25/2022 |
6.0.29 | 866 | 12/25/2022 |
6.0.17 | 1,842 | 4/24/2020 |
6.0.13 | 1,155 | 4/24/2020 |
6.0.12 | 1,158 | 4/18/2020 |
6.0.11 | 1,148 | 4/18/2020 |
6.0.10 | 1,167 | 4/18/2020 |
6.0.9 | 1,175 | 4/18/2020 |
6.0.8 | 1,236 | 9/24/2019 |
6.0.5 | 1,251 | 9/24/2019 |
5.0.37 | 1,282 | 6/18/2019 |
4.0.33 | 1,313 | 2/23/2019 |
4.0.30 | 1,252 | 2/23/2019 |
4.0.28 | 1,281 | 2/23/2019 |
4.0.27 | 1,351 | 2/14/2019 |
4.0.26 | 1,317 | 2/14/2019 |
4.0.25 | 1,337 | 2/14/2019 |
4.0.24 | 1,324 | 2/12/2019 |
4.0.23 | 1,322 | 1/29/2019 |
3.1.20 | 1,422 | 12/5/2018 |
3.1.17 | 1,499 | 9/8/2018 |
3.1.16 | 1,546 | 9/8/2018 |
3.1.15 | 1,437 | 9/8/2018 |
3.1.14 | 1,435 | 9/7/2018 |
3.1.13 | 1,438 | 9/7/2018 |
3.1.12 | 1,469 | 9/7/2018 |
3.1.11 | 1,508 | 8/23/2018 |
3.1.10 | 1,505 | 8/22/2018 |
3.1.8 | 1,462 | 8/16/2018 |
3.1.6 | 1,547 | 8/1/2018 |
3.1.5 | 1,456 | 8/1/2018 |
3.1.4 | 1,529 | 7/27/2018 |
3.1.3 | 1,496 | 7/27/2018 |
3.1.2 | 1,504 | 7/27/2018 |
3.1.1 | 1,477 | 7/26/2018 |
2.0.5 | 1,479 | 7/19/2018 |
2.0.4 | 1,679 | 5/24/2018 |
2.0.3 | 1,599 | 5/24/2018 |
2.0.1 | 1,651 | 5/9/2018 |
1.4.8 | 1,607 | 4/18/2018 |
1.4.7 | 1,568 | 4/18/2018 |
1.4.5 | 1,732 | 1/9/2018 |
1.4.1 | 1,696 | 1/9/2018 |
1.3.25 | 1,639 | 1/9/2018 |
1.3.19 | 1,686 | 12/20/2017 |
1.3.18 | 1,547 | 12/18/2017 |
1.3.17 | 1,635 | 12/15/2017 |
1.3.16 | 1,656 | 12/15/2017 |
1.3.14 | 1,655 | 12/15/2017 |
1.3.9 | 1,686 | 12/15/2017 |
1.3.8 | 1,663 | 12/15/2017 |
1.3.7 | 1,695 | 12/15/2017 |
1.3.5 | 1,668 | 12/15/2017 |
1.3.4 | 1,749 | 12/15/2017 |
1.3.3 | 1,697 | 12/15/2017 |
1.3.2 | 1,606 | 12/15/2017 |
1.3.1 | 1,586 | 11/30/2017 |
1.2.36 | 1,517 | 11/30/2017 |
1.2.34 | 1,570 | 11/29/2017 |
1.2.33 | 1,560 | 11/29/2017 |
1.2.31 | 1,545 | 11/29/2017 |
1.2.29 | 1,535 | 10/5/2017 |
1.2.28 | 1,544 | 10/4/2017 |
1.2.26 | 1,587 | 10/3/2017 |
1.2.25 | 1,556 | 10/3/2017 |
1.2.24 | 1,685 | 10/3/2017 |