GuiStracini.Mandae 8.0.764

There is a newer version of this package available.
See the version list below for details.
dotnet add package GuiStracini.Mandae --version 8.0.764                
NuGet\Install-Package GuiStracini.Mandae -Version 8.0.764                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GuiStracini.Mandae" Version="8.0.764" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GuiStracini.Mandae --version 8.0.764                
#r "nuget: GuiStracini.Mandae, 8.0.764"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install GuiStracini.Mandae as a Cake Addin
#addin nuget:?package=GuiStracini.Mandae&version=8.0.764

// Install GuiStracini.Mandae as a Cake Tool
#tool nuget:?package=GuiStracini.Mandae&version=8.0.764                

Mandaê SDK .NET

🇧🇷🚚 Mandaê API .NET client wrapper

Para a versão em português, por favor siga me.

GitHub license Time tracker GitHub issues by-label

Mandae logo

This is an unofficial client for the Mandaê API V2


CI/CD

Build status Last commit Tests Coverage Code Smells LoC
Build status GitHub last commit AppVeyor tests (branch) Coverage Code Smells Lines of Code

Code Quality (main branch)

Codacy Badge Codacy Badge

codecov CodeFactor

Maintainability Test Coverage

Quality Gate Status Maintainability Rating

Technical Debt Duplicated Lines (%)

Reliability Rating Security Rating

Bugs Vulnerabilities

DeepSource


Installation

Github Releases

GitHub last release Github All Releases

Download the latest zip file from the Release page.

Nuget package manager

Package Version Downloads
GuiStracini.Mandae GuiStracini.Mandae NuGet Version GuiStracini.Mandae NuGet Downloads

Features

This client supports the following operations/features of the API:

  1. Get rates for a delivery (postal code and package dimensions)
  2. 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)
  3. 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)
  4. WebHooks schema ready (The webhooks models, ready for implementation)
  5. Experimental Querying orders (API V1 - non-public API)
  6. Experimental Querying occurrences (API V1 - non-public API). Issue #1 GitHub labels
  7. Experimental Querying reverses (API V1 - non-public API). Issue #2 GitHub labels
  8. Experimental Request reverse (API V1 - non-public API). Issue #3 GitHub labels

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 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 is compatible.  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.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.847 79 4 days ago
8.0.844 90 9 days ago
8.0.841 75 23 days ago
8.0.838 77 a month ago
8.0.835 68 a month ago
8.0.832 79 a month ago
8.0.827 69 a month ago
8.0.820 73 a month ago
8.0.817 65 a month ago
8.0.814 59 a month ago
8.0.809 60 a month ago
8.0.800 71 a month ago
8.0.789 90 2 months ago
8.0.786 82 2 months ago
8.0.783 80 2 months ago
8.0.776 66 2 months ago
8.0.767 88 2 months ago
8.0.764 91 2 months ago
8.0.757 109 2 months ago
8.0.751 88 2 months ago
8.0.735 86 2 months ago
8.0.732 79 2 months ago
8.0.729 88 2 months ago
8.0.722 77 2 months ago
8.0.713 94 3 months ago
8.0.710 91 3 months ago
8.0.705 94 3 months ago
8.0.702 87 3 months ago
8.0.697 94 3 months ago
8.0.687 98 3 months ago
8.0.682 96 3 months ago
8.0.675 90 3 months ago
8.0.672 92 4 months ago
8.0.666 106 4 months ago
8.0.663 144 4 months ago
8.0.660 105 5 months ago
8.0.657 97 5 months ago
8.0.652 99 5 months ago
8.0.649 106 5 months ago
8.0.643 133 5 months ago
8.0.640 128 6 months ago
8.0.629 119 6 months ago
8.0.623 101 6 months ago
8.0.616 99 6 months ago
8.0.613 110 6 months ago
8.0.606 101 6 months ago
8.0.599 110 6 months ago
8.0.594 113 6 months ago
8.0.591 106 6 months ago
8.0.586 108 6 months ago
8.0.581 101 6 months ago
8.0.566 123 6 months ago
8.0.563 117 6 months ago
8.0.560 80 7 months ago
8.0.557 107 7 months ago
8.0.549 103 7 months ago
8.0.546 104 7 months ago
8.0.541 105 7 months ago
8.0.532 109 7 months ago
8.0.529 103 7 months ago
8.0.501 128 8 months ago
8.0.500 127 8 months ago
8.0.498 135 8 months ago
8.0.492 107 9 months ago
8.0.489 109 9 months ago
8.0.484 100 9 months ago
8.0.481 112 9 months ago
8.0.476 134 9 months ago
8.0.469 107 9 months ago
8.0.460 93 9 months ago
8.0.457 97 9 months ago
8.0.442 113 10 months ago
8.0.439 99 10 months ago
8.0.434 107 10 months ago
8.0.427 103 10 months ago
8.0.418 120 4/22/2024
8.0.415 96 4/22/2024
8.0.410 112 4/22/2024
8.0.403 136 4/15/2024
8.0.400 134 4/15/2024
8.0.395 131 4/15/2024
8.0.388 119 4/15/2024
8.0.379 154 4/8/2024
8.0.376 137 4/8/2024
8.0.371 142 4/8/2024
8.0.364 157 4/1/2024
8.0.361 174 3/25/2024
8.0.358 167 3/25/2024
8.0.353 188 3/18/2024
8.0.350 187 3/18/2024
8.0.345 235 3/11/2024
8.0.342 283 2/26/2024
8.0.339 272 2/26/2024
8.0.334 279 2/26/2024
8.0.327 268 2/26/2024
8.0.318 298 2/19/2024
8.0.310 294 2/19/2024
8.0.303 302 2/19/2024
8.0.294 305 2/14/2024
8.0.288 322 2/12/2024
8.0.285 346 2/5/2024
8.0.282 330 2/5/2024
8.0.277 354 1/30/2024
8.0.272 358 1/29/2024
8.0.269 351 1/29/2024
8.0.264 355 1/29/2024
8.0.254 390 1/22/2024
8.0.251 366 1/22/2024
8.0.246 360 1/22/2024
8.0.239 364 1/22/2024
8.0.230 417 1/16/2024
8.0.227 388 1/16/2024
8.0.222 390 1/15/2024
8.0.215 423 1/8/2024
8.0.212 415 1/8/2024
8.0.207 464 12/25/2023
8.0.204 450 12/25/2023
8.0.199 450 12/25/2023
8.0.192 450 12/25/2023
8.0.183 467 12/18/2023
8.0.178 456 12/18/2023
8.0.166 466 12/14/2023
8.0.157 478 12/12/2023
8.0.154 455 12/12/2023
8.0.149 466 12/12/2023
8.0.142 459 12/11/2023
8.0.137 460 12/11/2023
8.0.134 453 12/11/2023
8.0.114 491 12/8/2023
8.0.111 469 12/8/2023
8.0.108 490 12/8/2023
8.0.105 467 12/8/2023
8.0.96 465 12/8/2023
8.0.85 500 12/8/2023
8.0.59 1,642 11/14/2023
8.0.54 503 11/14/2023
8.0.49 503 11/13/2023
8.0.44 485 11/13/2023
8.0.37 523 11/9/2023
8.0.32 525 11/7/2023
8.0.27 504 11/6/2023
8.0.24 564 10/30/2023
8.0.21 525 10/30/2023
8.0.18 513 10/30/2023
8.0.13 562 10/22/2023
7.1.346 569 10/9/2023
7.1.343 543 10/9/2023
7.1.338 562 10/9/2023
7.1.335 567 10/9/2023
7.1.330 565 10/9/2023
7.1.323 572 10/7/2023
7.1.313 583 9/25/2023
7.1.308 587 9/24/2023
7.1.305 579 9/24/2023
7.1.298 586 9/23/2023
7.1.294 617 9/13/2023
7.1.287 623 9/13/2023
7.1.284 596 9/12/2023
7.1.281 595 9/12/2023
7.1.271 769 8/28/2023
7.1.263 833 8/14/2023
7.1.260 675 8/13/2023
7.1.227 672 8/13/2023
7.1.220 890 7/29/2023
7.1.218 747 7/29/2023
7.1.204 738 7/28/2023
7.1.200 761 7/25/2023
7.1.197 761 7/25/2023
7.1.190 814 7/19/2023
7.1.182 723 7/19/2023
7.1.157 961 6/27/2023
7.1.150 761 6/26/2023
7.1.145 849 6/19/2023
7.1.138 788 6/19/2023
7.1.135 755 6/19/2023
7.1.126 747 6/18/2023
7.1.107 925 6/6/2023
7.1.104 765 6/6/2023
7.1.95 761 6/6/2023
7.1.75 814 6/5/2023
7.1.17 1,180 5/4/2023
7.1.16 750 5/2/2023
7.1.15 826 4/28/2023
7.1.10 789 4/21/2023
7.1.8 805 4/21/2023
7.1.2 967 4/10/2023
7.0.101 791 4/8/2023
7.0.97 830 4/4/2023
7.0.92 927 4/3/2023
7.0.86 849 4/3/2023
7.0.64 902 3/26/2023
7.0.59 843 3/26/2023
7.0.43 856 3/22/2023
7.0.36 948 2/4/2023
7.0.31 1,014 1/24/2023
7.0.28 912 1/24/2023
7.0.25 920 1/24/2023
7.0.13 904 1/23/2023
7.0.8 874 1/23/2023
6.0.46 1,183 1/16/2023
6.0.43 935 1/16/2023
6.0.31 934 1/9/2023
6.0.30 950 12/25/2022
6.0.29 877 12/25/2022
6.0.17 1,854 4/24/2020
6.0.13 1,167 4/24/2020
6.0.12 1,168 4/18/2020
6.0.11 1,177 4/18/2020
6.0.10 1,179 4/18/2020
6.0.9 1,194 4/18/2020
6.0.8 1,248 9/24/2019
6.0.5 1,264 9/24/2019
5.0.37 1,294 6/18/2019
4.0.33 1,327 2/23/2019
4.0.30 1,270 2/23/2019
4.0.28 1,294 2/23/2019
4.0.27 1,365 2/14/2019
4.0.26 1,331 2/14/2019
4.0.25 1,350 2/14/2019
4.0.24 1,340 2/12/2019
4.0.23 1,336 1/29/2019
3.1.20 1,439 12/5/2018
3.1.17 1,520 9/8/2018
3.1.16 1,566 9/8/2018
3.1.15 1,455 9/8/2018
3.1.14 1,454 9/7/2018
3.1.13 1,458 9/7/2018
3.1.12 1,489 9/7/2018
3.1.11 1,527 8/23/2018
3.1.10 1,522 8/22/2018
3.1.8 1,479 8/16/2018
3.1.6 1,566 8/1/2018
3.1.5 1,473 8/1/2018
3.1.4 1,547 7/27/2018
3.1.3 1,513 7/27/2018
3.1.2 1,521 7/27/2018
3.1.1 1,495 7/26/2018
2.0.5 1,498 7/19/2018
2.0.4 1,699 5/24/2018
2.0.3 1,620 5/24/2018
2.0.1 1,670 5/9/2018
1.4.8 1,627 4/18/2018
1.4.7 1,587 4/18/2018
1.4.5 1,760 1/9/2018
1.4.1 1,718 1/9/2018
1.3.25 1,662 1/9/2018
1.3.19 1,707 12/20/2017
1.3.18 1,565 12/18/2017
1.3.17 1,657 12/15/2017
1.3.16 1,677 12/15/2017
1.3.14 1,675 12/15/2017
1.3.9 1,707 12/15/2017
1.3.8 1,685 12/15/2017
1.3.7 1,721 12/15/2017
1.3.5 1,689 12/15/2017
1.3.4 1,770 12/15/2017
1.3.3 1,718 12/15/2017
1.3.2 1,629 12/15/2017
1.3.1 1,620 11/30/2017
1.2.36 1,541 11/30/2017
1.2.34 1,588 11/29/2017
1.2.33 1,578 11/29/2017
1.2.31 1,563 11/29/2017
1.2.29 1,555 10/5/2017
1.2.28 1,562 10/4/2017
1.2.26 1,606 10/3/2017
1.2.25 1,574 10/3/2017
1.2.24 1,707 10/3/2017

Upgrade to .NET Standard 2.0 and 2.1