Freight

Exemplo 5 – Integração com a Trip API

O serviço Freight API pode ser utilizado de forma integrada com a Trip API. O processo consiste em apenas adicionar os parâmetros da Freight API no body da requisição para a Trip API.

Não será necessário incluir o parâmetro distance, já que a própria Trip API fornecerá a informação da distância percorrida.

O exemplo a seguir exibe uma requisição de um rota entre São Paulo – SP e Campinas – SP, a ser percorrida por um caminhão com 4 eixos duplos, incluindo cálculo de pedágios e frete (Carga: Granel sólido / Tipo de operação: D). 

Endpoint utilizado: https://api.maplink.global/trip/v1/problems (Método: POST)

A requisição completa encontra-se abaixo:

{
   "calculationMode": "THE_FASTEST",   
   "points": [
       {
           "latitude": -23.566329,
           "longitude": -46.653690,
           "siteId": "SP"
       },
       {
           "latitude": -22.910884,
           "longitude": -47.066027,
           "siteId": "CAMPINAS"
       }
   ],
   "toll": {
       "vehicleType": "TRUCK_WITH_FOUR_DOUBLE_AXLES"
   },
   "freight": {
       "operationType": [
           "D"
       ],
       "goodsType": [
           "GRANEL_SOLIDO"
       ],
       "axis": [
           "4"
       ],
       "roundTrip": false,
       "backEmpty": false,
       "otherCosts": [
           {
               "name": "ICMS",
                "type": "PERCENT",
               "value": "5"
           },
           {
               "name": "Lucro",
               "type": "PERCENT",
               "value": "20"
           },
           {
               "name": "TaxaFixa",
               "type": "FIXED",
               "value": "500"
           }
       ],
       "date": "2021-10-02"
   }
}

Onde:

  • O parâmetro points contém as coordenadas para uma roteirização simples entre São Paulo e Campinas;
  • O parâmetro toll contém os dados dos pedágios presentes na rota;.
  • O parâmetro freight contém os dados do frete mínimo para a rota.
{
    "id": "691391a476efb7292af2c0b7",
    "clientId": "qBPERsYpGuBp9ksxA1EGncIYlVM8ULee",
    "totalDistance": 91623,
    "totalNominalDuration": 4508,
    "averageSpeed": 55.37,
    "tollCosts": 109.20,
    "routeFreightCost": 1067.85,
    "legs": [
        {
            "distance": 91623,
            "nominalDuration": 4508,
            "averageSpeed": 55.37,
            "points": "txynCj`w{G}A{AeE_EcEfFeIjKyDzEgE~E_@`@g@b@_EtEwJ|KETGHYb@cArAqBvB_BrBCHIROh@Ep@?RHf@xArFLj@D`@@h@?n@G`@M`@qBnFIZeIfX_BfFy@vCg@zAo@zBeAhDw@zBeBhD_CpDg@t@[XUb@aB`GS\\_AjAt@_@B?HDBDBJCnBBfAM|IAx@CbBEb@Kb@Uf@MPe@l@y@x@u@t@mAjBm@`By@vCMn@ATDbB@rAA^MbAWvAUl@y@fBoCfEEXkBrCaAbBgAtBo@dAo@z@sClCkBfB_AzAe@|@_@z@OV_@j@QRs@b@oBbA{BfAa@N[H_@DcOz@_CD_B?}@Y_@GY@YFaB^_ATiBNu@JMESFgARg@Hk@Dq@?oBGcAGeEM_ECwRWsY[oECYj@uDvO]zAMb@MJIBM?SC_@W[e@i@q@Y[oAgAe@]c@Y_HaEqAw@yFeD_@MUCOAM@_@Jc@RWvB}AnN_@zBy@|BmBpEiBzEw@zAY^[R_@Po@LYBa@@u@OOEoBaAMZU\\KDMLKFOFIT{Ot@e@CSESGKIIOEMEO?O?KDQLWHMJIJELCP?\\DTJFHP`@D`@HJLfCBzAJvCAdBGdDQtDa@|HSlE[vJGnBKjCEzB?jABz@Bv@Fv@BJ@LHpAN`BXdCDv@@~@Cf@C^Id@Qt@Wx@e@`Ac@v@s@~@aAjAINeDdDiHbGwBnBaQpOsCtByGjE_GzCsLbHsBvAgCjBwFpEcSfP}BvAaDvAmBh@gC`@wKp@{SzAsB`@gDdAmClAsClByBjBcBlBeB`CqArCkDhKgAhDoAdDy@bB_AxA}@fA}AxAqAz@eB|@gBn@_JtCcH~BuHdCkMnEwGrBcB\\qAT}ATiW~CuH|@{OnBwARiPnB}S~BoOxBmFp@kDb@{B`@_Bb@cCt@aO|FiRlHmEnAcAL}BRqIP_O`@iQb@qFPwCJmBJoCb@mEzAgGvCqQxIaOfHkBv@sBt@sBz@sA^qCr@cDp@cDh@wC^uCTsDPeCFuBA{b@XgEH}FZkBNoAFmBNuCNiSnA}Kr@_H\\qA@oILyDHgQRyDXiDh@eDz@{CtAaDpBaDzCkDjEeNpQaCvCqDfE{ApAkA|@sAz@qKnFmBbAcb@vSeBr@cAXaCf@}BZsFl@_ALqAV_AVqAd@cD~Ak@^q@d@{A`BgAzAs@nASd@gA|Cc@`BcBbLo@xCYbAo@bB[n@_@l@kAfBmDhE{@x@uBxCsBpDaAtBo@zAkAtDYbAQx@Mz@e@hEEfAIdAu@|Ne@pIe@rIMtAOdAUvAu@fDq@`CkAxCyBxDgAvA{DnEcEpEkDpDuN|NiD|DyGfHqAjAkAbAuA`AaBfAyDtBqAj@qCdA{C|@cCh@mAVaBToBTwBN{AJ}FNs@?oVRsOPiBBqB@w@@u@?wAB[?U?c@@c@?eGHyQPoGJ{@FaAH_AN{@P}@V_A\\sBbAmAr@sAfAs@n@o@r@i@r@g@x@c@x@a@~@]|@Y`AyChLyDfOsBvFc@z@q@fA[d@{@fAm@t@oCnCeD~C{NrN_CvBiA|@aBbAsAn@}@X{@TcARw@JoCTaUlA{AL_BTkB`@yBr@oAl@oAr@k@b@q@l@c@`@uClDqFxGmA|Ag@j@m@j@q@l@[Va@X]Rg@XwAj@gA^aATwARgBP_FXkFTeZ`BoDTsCRqAL_ANy@Pc@LwAb@oAh@e@Ve@ZkAz@e@`@e@b@a@d@oFfHiEnF}ClEoC`D]^e@d@oAbA}CvBmAr@gHlE}@n@yBlBaA~@k@n@k@r@i@r@uArB[XQRm@bAu@pAuF|I_CxDi@t@yAhBq@r@o@n@q@l@_BnAaAn@wAv@CBk@\\w@\\u@Z_Bh@kGdB_B\\aAXaBL}@Dy@B_AAaACq@C_AK{@Kw@MeCg@gOaDmAUoAS{@W_@EqAE{@Aw@DyBNwCd@_B^aJhDcMfFqAb@cAZo@NmBVmHp@{E^}@F_AJ{@LgAPuCr@sBj@qCbAsGhCgHvCoD|Ay@Z_FlBeEhBk@ZeBl@aBr@u@VaMdFkBx@_CpAoAz@{AhA_G|EyHpG{@~@cCnBkCzBmGbFoBbByAtAsBxBaBlBmB`CqBtCw@lAqA|BsDvGiDrGcB~C_ElIeAnBaQt[wCnEmBlC_CbCqAnAqAfAuAdAgBjAkBhAuAp@qDdBqBn@uAl@mD~@mQvE{SpFcCp@yHpBmYxHeCv@yAf@kDrA{Ap@uBdAyBhA_B`AmAt@yB|AmA|@eEjDeB`Bi@h@aAdAsAzAeFtGgClD}A|BiClD_FbHkCnDwDrFmDvEuArBsFvHwCvD{AhBoCrCwBvBoErDm@b@qCpBeBjAsDxByH|D}Ax@qMvGkFpCoFnC_GlCmCjAqDvAkDjAgDhAcOtEmJ|CaFrAuItC{B|@eHxBmGhByFtBkChAaCjAsDvBmD`C}GlF}HpHoAnAuOjOoNrM{DpCiFrCmCvAeChAu@V_DfAoEjAkH|Ao]xG}HnBqH~BqEjBuBv@wBbAoc@vVow@bd@{\\zRsGjDmFzCmThMuJrFqKfGeAn@uI|EkDxBiHtEkKbHoGxEaGbEql@ha@gTbO}CrBiFpDoAv@oNzJ}EfD_FbDeGlDaCvAaC|AmEhCcIjEqBhA{BjAmBjAwTvLcLjGsEbCiB~@uCbBwGlDcB~@cBz@qFbCiG~BeCz@gCv@eRxEwCx@aCx@}B`AwAn@qAn@uM`HoMhHq]~QaFpCiStKgItEcCpA{BnAWLc@VqJhFyRlKyC`B_NjHiJnFaCpAcAl@sHvE}NhJ}FrD}FtDuCfBuJhGwPfKiG~DeEhCkBnAcW`PwGzDyEdC{FvCcPtHcFdC}@`@ee@xTkGrCuI`E{DdBcFfCqCpAqgAjh@iMfGcUlKqAX}B|@aE`Ba@L_@HoB~@mBdAyG|CeLnFeGpCiDbBcAj@aAn@yF`EwAv@YJYJQBQ?YAc@Ie@E_BI_BAUE[Ig@Y[YOEGKk@u@s@q@iI}EmOoIqBq@s@Sy@QaLaCmGyACAmAW{TyEsDy@KKw@WQGMIIIIOEU@c@CIEIIIMEqCTyALg@I]OeBi@k@Om@]qCq@sDy@oAMoBYqAEEVw@pDaBfJlCh@",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "13",
                        "type": "TOLL_BOOTH",
                        "name": "Pedágio - Campo Limpo",
                        "address": "SP-348 - Rodovia dos Bandeirantes - Km 39",
                        "city": "Cajamar",
                        "state": {
                            "name": "São Paulo",
                            "code": "SP"
                        },
                        "country": "Brasil",
                        "concession": "Autoban",
                        "direction": "NORTH",
                        "coordinates": {
                            "latitude": -23.3260346,
                            "longitude": -46.8231453
                        },
                        "serviceTypes": [
                            {
                                "serviceId": "48",
                                "name": "Via Facil"
                            },
                            {
                                "serviceId": "35353480390470101",
                                "name": "ANTTCODE"
                            }
                        ],
                        "price": 54.80
                    },
                    {
                        "id": "73",
                        "type": "TOLL_BOOTH",
                        "name": "Pedágio - Valinhos Norte",
                        "address": "SP-330 - Rodovia Anhanguera - Km 82",
                        "city": "Valinhos",
                        "state": {
                            "name": "São Paulo",
                            "code": "SP"
                        },
                        "country": "Brasil",
                        "concession": "Autoban",
                        "direction": "NORTHWEST",
                        "coordinates": {
                            "latitude": -23.01295484,
                            "longitude": -47.0230555
                        },
                        "serviceTypes": [
                            {
                                "serviceId": "50",
                                "name": "Via Facil"
                            },
                            {
                                "serviceId": "35353300820000101",
                                "name": "ANTTCODE"
                            }
                        ],
                        "price": 54.40
                    }
                ],
                "legTotalCost": 109.20,
                "vehicleType": "TRUCK_WITH_FOUR_DOUBLE_AXLES",
                "calculationDate": 1762890148366
            },
            "arrivalSiteId": "CAMPINAS",
            "departureSiteId": "SP"
        }
    ],
    "freight": {
        "source": "RESOLUÇÃO No 5.949, DE 13 DE JULHO DE 2021",
        "results": {
            "D": {
                "4": {
                    "GRANEL_SOLIDO": {
                        "value": 366.91,
                        "otherCosts": {
                            "ICMS": 18.35,
                            "Lucro": 73.39,
                            "TaxaFixa": 500
                        }
                    }
                }
            }
        },
        "minimumFreight": 366.91,
        "minimumFreightWithCosts": 958.65
    },
    "source": "MAPLINK",
    "createdAt": 1762890148365,
    "expiryIn": 1763494948365
}