GuiStracini.Mandae
8.0.732
See the version list below for details.
dotnet add package GuiStracini.Mandae --version 8.0.732
NuGet\Install-Package GuiStracini.Mandae -Version 8.0.732
<PackageReference Include="GuiStracini.Mandae" Version="8.0.732" />
paket add GuiStracini.Mandae --version 8.0.732
#r "nuget: GuiStracini.Mandae, 8.0.732"
// Install GuiStracini.Mandae as a Cake Addin #addin nuget:?package=GuiStracini.Mandae&version=8.0.732 // Install GuiStracini.Mandae as a Cake Tool #tool nuget:?package=GuiStracini.Mandae&version=8.0.732
Mandaê SDK .NET
🇧🇷🚚 Mandaê API .NET client wrapper
Para a versão em português, por favor siga me.
This is an unofficial 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 centre with one or more packages. Each package can have one or more items/SKU)
- 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 webhooks models, ready for implementation)
- Experimental Querying orders (API V1 - non-public API)
- Experimental Querying occurrences (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 its own API token!
var apiToken = "my API token";
//Call the constructor with the API token and the 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 a 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 an 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 further use (maybe cancel the request ?)
Get tracking of a package
Example:
//The MandaeClient
var client = new MandaeClient("my API token");
//The tracking identifier (Generated by the Mandae or sent by the order collection request
var trackingId = "MyCompany-00001";
var tracking = client.GetTracking(tracking);
//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 the Mandaê panel to log in V1 API.
Example:
//The MandaeClient
var client = new MandaeClient("V2 API token");
client.ConfigureV1Authentication("myEmail@example.com", "password");
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ê panel to log in to the V1 API.
- Release v1.4.1 and higher also includes an experimental (non-public) V1 endpoint for search/querying orders (the same interface as available through the Mandaê administration panel).
Warning
The API V1 is not officially public, so there is no warranty that it will still be working
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- GuiStracini.SDKBuilder (>= 3.0.644)
- Microsoft.AspNet.WebApi.Client (>= 6.0.0)
-
.NETStandard 2.1
- GuiStracini.SDKBuilder (>= 3.0.644)
- Microsoft.AspNet.WebApi.Client (>= 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.735 | 26 | 12/23/2024 |
8.0.732 | 25 | 12/23/2024 |
8.0.729 | 30 | 12/23/2024 |
8.0.722 | 26 | 12/23/2024 |
8.0.713 | 75 | 12/9/2024 |
8.0.710 | 73 | 12/9/2024 |
8.0.705 | 80 | 12/2/2024 |
8.0.702 | 75 | 12/2/2024 |
8.0.697 | 80 | 12/2/2024 |
8.0.687 | 88 | 11/25/2024 |
8.0.682 | 84 | 11/25/2024 |
8.0.675 | 80 | 11/18/2024 |
8.0.672 | 82 | 10/28/2024 |
8.0.666 | 95 | 10/21/2024 |
8.0.663 | 120 | 10/14/2024 |
8.0.660 | 100 | 10/2/2024 |
8.0.657 | 92 | 10/2/2024 |
8.0.652 | 96 | 9/23/2024 |
8.0.649 | 101 | 9/23/2024 |
8.0.643 | 128 | 9/16/2024 |
8.0.640 | 125 | 9/10/2024 |
8.0.629 | 116 | 9/3/2024 |
8.0.623 | 100 | 8/29/2024 |
8.0.616 | 96 | 8/29/2024 |
8.0.613 | 107 | 8/29/2024 |
8.0.606 | 95 | 8/28/2024 |
8.0.599 | 105 | 8/27/2024 |
8.0.594 | 108 | 8/26/2024 |
8.0.591 | 99 | 8/26/2024 |
8.0.586 | 105 | 8/26/2024 |
8.0.581 | 97 | 8/26/2024 |
8.0.566 | 122 | 8/19/2024 |
8.0.563 | 116 | 8/12/2024 |
8.0.560 | 79 | 7/29/2024 |
8.0.557 | 104 | 7/22/2024 |
8.0.549 | 101 | 7/16/2024 |
8.0.546 | 100 | 7/16/2024 |
8.0.541 | 101 | 7/16/2024 |
8.0.532 | 105 | 7/16/2024 |
8.0.529 | 99 | 7/16/2024 |
8.0.501 | 124 | 6/19/2024 |
8.0.500 | 124 | 6/18/2024 |
8.0.498 | 131 | 6/18/2024 |
8.0.492 | 103 | 6/3/2024 |
8.0.489 | 107 | 6/3/2024 |
8.0.484 | 96 | 5/28/2024 |
8.0.481 | 110 | 5/28/2024 |
8.0.476 | 119 | 5/28/2024 |
8.0.469 | 105 | 5/28/2024 |
8.0.460 | 91 | 5/20/2024 |
8.0.457 | 93 | 5/15/2024 |
8.0.442 | 111 | 4/29/2024 |
8.0.439 | 97 | 4/29/2024 |
8.0.434 | 103 | 4/29/2024 |
8.0.427 | 101 | 4/29/2024 |
8.0.418 | 116 | 4/22/2024 |
8.0.415 | 91 | 4/22/2024 |
8.0.410 | 110 | 4/22/2024 |
8.0.403 | 132 | 4/15/2024 |
8.0.400 | 132 | 4/15/2024 |
8.0.395 | 127 | 4/15/2024 |
8.0.388 | 115 | 4/15/2024 |
8.0.379 | 152 | 4/8/2024 |
8.0.376 | 135 | 4/8/2024 |
8.0.371 | 138 | 4/8/2024 |
8.0.364 | 155 | 4/1/2024 |
8.0.361 | 172 | 3/25/2024 |
8.0.358 | 165 | 3/25/2024 |
8.0.353 | 186 | 3/18/2024 |
8.0.350 | 185 | 3/18/2024 |
8.0.345 | 233 | 3/11/2024 |
8.0.342 | 281 | 2/26/2024 |
8.0.339 | 270 | 2/26/2024 |
8.0.334 | 262 | 2/26/2024 |
8.0.327 | 266 | 2/26/2024 |
8.0.318 | 292 | 2/19/2024 |
8.0.310 | 288 | 2/19/2024 |
8.0.303 | 294 | 2/19/2024 |
8.0.294 | 298 | 2/14/2024 |
8.0.288 | 320 | 2/12/2024 |
8.0.285 | 344 | 2/5/2024 |
8.0.282 | 328 | 2/5/2024 |
8.0.277 | 352 | 1/30/2024 |
8.0.272 | 356 | 1/29/2024 |
8.0.269 | 349 | 1/29/2024 |
8.0.264 | 353 | 1/29/2024 |
8.0.254 | 388 | 1/22/2024 |
8.0.251 | 364 | 1/22/2024 |
8.0.246 | 358 | 1/22/2024 |
8.0.239 | 362 | 1/22/2024 |
8.0.230 | 415 | 1/16/2024 |
8.0.227 | 386 | 1/16/2024 |
8.0.222 | 388 | 1/15/2024 |
8.0.215 | 421 | 1/8/2024 |
8.0.212 | 413 | 1/8/2024 |
8.0.207 | 462 | 12/25/2023 |
8.0.204 | 448 | 12/25/2023 |
8.0.199 | 448 | 12/25/2023 |
8.0.192 | 448 | 12/25/2023 |
8.0.183 | 465 | 12/18/2023 |
8.0.178 | 454 | 12/18/2023 |
8.0.166 | 464 | 12/14/2023 |
8.0.157 | 476 | 12/12/2023 |
8.0.154 | 453 | 12/12/2023 |
8.0.149 | 464 | 12/12/2023 |
8.0.142 | 457 | 12/11/2023 |
8.0.137 | 458 | 12/11/2023 |
8.0.134 | 451 | 12/11/2023 |
8.0.114 | 487 | 12/8/2023 |
8.0.111 | 467 | 12/8/2023 |
8.0.108 | 488 | 12/8/2023 |
8.0.105 | 463 | 12/8/2023 |
8.0.96 | 460 | 12/8/2023 |
8.0.85 | 496 | 12/8/2023 |
8.0.59 | 1,518 | 11/14/2023 |
8.0.54 | 499 | 11/14/2023 |
8.0.49 | 499 | 11/13/2023 |
8.0.44 | 470 | 11/13/2023 |
8.0.37 | 519 | 11/9/2023 |
8.0.32 | 520 | 11/7/2023 |
8.0.27 | 499 | 11/6/2023 |
8.0.24 | 560 | 10/30/2023 |
8.0.21 | 521 | 10/30/2023 |
8.0.18 | 509 | 10/30/2023 |
8.0.13 | 558 | 10/22/2023 |
7.1.346 | 563 | 10/9/2023 |
7.1.343 | 537 | 10/9/2023 |
7.1.338 | 558 | 10/9/2023 |
7.1.335 | 560 | 10/9/2023 |
7.1.330 | 559 | 10/9/2023 |
7.1.323 | 566 | 10/7/2023 |
7.1.313 | 577 | 9/25/2023 |
7.1.308 | 583 | 9/24/2023 |
7.1.305 | 572 | 9/24/2023 |
7.1.298 | 580 | 9/23/2023 |
7.1.294 | 611 | 9/13/2023 |
7.1.287 | 619 | 9/13/2023 |
7.1.284 | 591 | 9/12/2023 |
7.1.281 | 591 | 9/12/2023 |
7.1.271 | 765 | 8/28/2023 |
7.1.263 | 827 | 8/14/2023 |
7.1.260 | 669 | 8/13/2023 |
7.1.227 | 666 | 8/13/2023 |
7.1.220 | 884 | 7/29/2023 |
7.1.218 | 741 | 7/29/2023 |
7.1.204 | 732 | 7/28/2023 |
7.1.200 | 755 | 7/25/2023 |
7.1.197 | 757 | 7/25/2023 |
7.1.190 | 808 | 7/19/2023 |
7.1.182 | 716 | 7/19/2023 |
7.1.157 | 957 | 6/27/2023 |
7.1.150 | 755 | 6/26/2023 |
7.1.145 | 843 | 6/19/2023 |
7.1.138 | 783 | 6/19/2023 |
7.1.135 | 751 | 6/19/2023 |
7.1.126 | 741 | 6/18/2023 |
7.1.107 | 918 | 6/6/2023 |
7.1.104 | 759 | 6/6/2023 |
7.1.95 | 755 | 6/6/2023 |
7.1.75 | 810 | 6/5/2023 |
7.1.17 | 1,173 | 5/4/2023 |
7.1.16 | 744 | 5/2/2023 |
7.1.15 | 820 | 4/28/2023 |
7.1.10 | 783 | 4/21/2023 |
7.1.8 | 799 | 4/21/2023 |
7.1.2 | 963 | 4/10/2023 |
7.0.101 | 787 | 4/8/2023 |
7.0.97 | 826 | 4/4/2023 |
7.0.92 | 921 | 4/3/2023 |
7.0.86 | 845 | 4/3/2023 |
7.0.64 | 895 | 3/26/2023 |
7.0.59 | 836 | 3/26/2023 |
7.0.43 | 852 | 3/22/2023 |
7.0.36 | 944 | 2/4/2023 |
7.0.31 | 1,010 | 1/24/2023 |
7.0.28 | 908 | 1/24/2023 |
7.0.25 | 916 | 1/24/2023 |
7.0.13 | 902 | 1/23/2023 |
7.0.8 | 870 | 1/23/2023 |
6.0.46 | 1,179 | 1/16/2023 |
6.0.43 | 931 | 1/16/2023 |
6.0.31 | 930 | 1/9/2023 |
6.0.30 | 946 | 12/25/2022 |
6.0.29 | 873 | 12/25/2022 |
6.0.17 | 1,852 | 4/24/2020 |
6.0.13 | 1,163 | 4/24/2020 |
6.0.12 | 1,166 | 4/18/2020 |
6.0.11 | 1,173 | 4/18/2020 |
6.0.10 | 1,175 | 4/18/2020 |
6.0.9 | 1,190 | 4/18/2020 |
6.0.8 | 1,244 | 9/24/2019 |
6.0.5 | 1,260 | 9/24/2019 |
5.0.37 | 1,292 | 6/18/2019 |
4.0.33 | 1,322 | 2/23/2019 |
4.0.30 | 1,265 | 2/23/2019 |
4.0.28 | 1,289 | 2/23/2019 |
4.0.27 | 1,360 | 2/14/2019 |
4.0.26 | 1,326 | 2/14/2019 |
4.0.25 | 1,345 | 2/14/2019 |
4.0.24 | 1,333 | 2/12/2019 |
4.0.23 | 1,333 | 1/29/2019 |
3.1.20 | 1,434 | 12/5/2018 |
3.1.17 | 1,517 | 9/8/2018 |
3.1.16 | 1,563 | 9/8/2018 |
3.1.15 | 1,452 | 9/8/2018 |
3.1.14 | 1,451 | 9/7/2018 |
3.1.13 | 1,453 | 9/7/2018 |
3.1.12 | 1,486 | 9/7/2018 |
3.1.11 | 1,522 | 8/23/2018 |
3.1.10 | 1,519 | 8/22/2018 |
3.1.8 | 1,476 | 8/16/2018 |
3.1.6 | 1,561 | 8/1/2018 |
3.1.5 | 1,468 | 8/1/2018 |
3.1.4 | 1,542 | 7/27/2018 |
3.1.3 | 1,508 | 7/27/2018 |
3.1.2 | 1,516 | 7/27/2018 |
3.1.1 | 1,489 | 7/26/2018 |
2.0.5 | 1,493 | 7/19/2018 |
2.0.4 | 1,692 | 5/24/2018 |
2.0.3 | 1,613 | 5/24/2018 |
2.0.1 | 1,663 | 5/9/2018 |
1.4.8 | 1,620 | 4/18/2018 |
1.4.7 | 1,580 | 4/18/2018 |
1.4.5 | 1,751 | 1/9/2018 |
1.4.1 | 1,709 | 1/9/2018 |
1.3.25 | 1,653 | 1/9/2018 |
1.3.19 | 1,698 | 12/20/2017 |
1.3.18 | 1,559 | 12/18/2017 |
1.3.17 | 1,647 | 12/15/2017 |
1.3.16 | 1,668 | 12/15/2017 |
1.3.14 | 1,666 | 12/15/2017 |
1.3.9 | 1,698 | 12/15/2017 |
1.3.8 | 1,676 | 12/15/2017 |
1.3.7 | 1,712 | 12/15/2017 |
1.3.5 | 1,680 | 12/15/2017 |
1.3.4 | 1,761 | 12/15/2017 |
1.3.3 | 1,709 | 12/15/2017 |
1.3.2 | 1,620 | 12/15/2017 |
1.3.1 | 1,597 | 11/30/2017 |
1.2.36 | 1,535 | 11/30/2017 |
1.2.34 | 1,582 | 11/29/2017 |
1.2.33 | 1,572 | 11/29/2017 |
1.2.31 | 1,557 | 11/29/2017 |
1.2.29 | 1,549 | 10/5/2017 |
1.2.28 | 1,556 | 10/4/2017 |
1.2.26 | 1,600 | 10/3/2017 |
1.2.25 | 1,568 | 10/3/2017 |
1.2.24 | 1,697 | 10/3/2017 |
Upgrade to .NET Standard 2.0 and 2.1