ShipHub Request Label

The purpose of this page is to describe how to obtain a label for ShipHub based on previous steps and information

API Call: /createShipment

Method: POST

Parameters: The createShipment call works exactly the same as the getRates with the need of a few additional parameters to be specified so we can request the actual label after all 🙂

Below you will see a full example and full mapping again with the different fields being marked in the field name type with an icon ⚠ so they can be specifically checked

Example Payload:

{
  "addresses": [
    {
      "address_1": "251 Little Falls Drive",
      "zip": "19808",
      "city": "Wilmington",
      "residential": false,
      "contact": {
        "name": "Danail Deltchev",
        "contact_name": "Threecolts LLC",
        "email": "ddeltchev@threecolts.com",
        "phone": "2126654322"
      },
      "country": "US",
      "state": "DE",
      "assignment": "from"
    },
    {
      "address_1": "233 S Wacker Dr",
      "zip": "60606",
      "city": "Chicago",
      "residential": false,
      "contact": {
        "name": "Charlie Smith",
        "phone": "2126654322"
      },
      "country": "US",
      "state": "IL",
      "assignment": "to"
    }
  ],
  "options": {
    "LengthUnit": {
      "value": "IN"
    },
    "Package Type": {
      "value": "Envelope"
    },
    "Print Receipt on Label": {
      "value": 0
    },
    "Signature": {
      "value": "Adult Signature"
    },
    "WeightUnit": {
      "value": "LB"
    },
    "isReturn": {
      "value": false
    },
    "Saturday Delivery": {
      "value": 0
    },
    "Label Type": {
      "value": "4 X 6 Label",
      "label_format": "PDF"
    }
  },
  "packages": [
    {
      "quantity": 1,
      "weight": 0.0,
      "options": {
        "Reference": {
          "value": "ORDER-IL003"
        }
      }
    }
  ],
  "carrier": "UPS",
  "carrier_service": "02"
}

Both of these will be mapped together in the following Address fields | | | address_1 | | | Y | from: Location > Street1

to: Orders > Shipping Street 1 | If Any field is longer than 35 characters we should break on the first space before the 35th character and move everything else to be concatenated with the relevant street2 field (with a space between the two values left). If the new value for address_2 is also longer than 35 characters we need to break again on the first space before the 35th character and move to address_3

If no spaces are found in a specific such field break on the 35th character exactly | | | address_2 | | | N | from: Location > Street2

to: Orders > Shipping Street 2 | | | | address_3 | | | N | * | As per the above note | | | zip | | | Y | from: Location > Post Code

to: Orders > Shipping Postal Code | | | | city | | | Y | from: Location > City

to: Orders > Shipping City | | | | contact | | | Y | | | | | | name | | N | from: Location > Company Name OR Contact Name

to: Orders > Shipping Buyer Name | For the “from” address “Company Name” is with priority if both are filled in | | | | contact_name | | Y | from: Location > Contact Name

to: Orders > Shipping Buyer Name | | | | | email | | Y | from: Location > Email

to: Orders > Buyer mail | | | | | phone | | Y | from: Location > Phone

to: Orders > Shipping Phone | | | | country | | | Y | from: Location > Country 2 char code

to: Orders > Shipping Country Code | In to address if we don’t have the “Shipping Country Code” we have to obtain it by lookup with the “Shipping Country Name” | | | state | | | N | from: Location > State Province

to: Orders > Shipping State Province | For both addresses we want to ensure we are sending a 2 letter Iso code of the state. If in address field we have 2 characters we have to check they are a valid state value. If we have a state name we have to map via lookup list and use the 2 char code. If not present don’t send | | | assignment | | | Y | * | As mentioned we always have to send 2 address objects differentiating only by the “assignment” being to and from | | options | | | | Y | | | | | LengthUnit | | | | | | | | | value | | Y | “IN” | Hardcoded | | | Package Type | | | | | | | | | value | | Y | “Customer Packaging” | Hardcoded | | | Print Receipt on Label | | | | | | | | | value | | N | Courier Shipping Providers > ShipHub Section > Print Receipt on Label | Yes or No (send 1 or 0)

IF there is no record set for this use: “0” as default | | | Signature | | | | | | | | | value | | N | Courier Shipping Providers > ShipHub Section > Signature | No Special Signature,

Adult Signature,

Direct Signature,

Indirect Signature #########

If first option is chosen don’t send Signature at all. For the rest pass the direct value selected. IF there is no record set for this don’t send this field as default | | | WeightUnit | | | | | | | | | value | | Y | "LB” | Hardcoded

We have to transform our weight from Grams to Pounds | | | isReturn | | | | | | | | | value | | Y | “false” | Hardcoded | | | Saturday Delivery | | | | | | | | | value | | N | Courier Shipping Providers > ShipHub Section > Saturday Delivery | Yes or No (send 1 or 0)

IF there is no record set for this send 0 as default | | | ⚠ Label Type | | | | | | | | | value | | Y | Courier Shipping Providers > ShipHub Section > Label Type | Two options in the dropdown:

STANDARD 8.5 X11 Paper

and

4 X 6 Label

Please make this field mandatory in the ShipHub section of the Courier Shipping Providers | | | | label_format | | Y | “PDF” | Hardcoded | | packages | | | | | | | | | quantity | | | Y | “1” | Hardcoded | | | weight | | | Y | Products in Order > Weight | Multiplied by quantity of each product and summed between the products to get the final weight of the parcel

Note: weight should be converted accordingly not just summed | | | options | | | Y | | | | | | Reference | | | | | | | | | value | Y | Orders > ID + timestamp | Concatenate the two to achieve a unique reference every time we request a label for said order | | ⚠ carrier | | | | Y | | Whatever is selected from the bulk request or from the single request for the label. Should be the value carrier from the getRates response | | ⚠ carrier_service | | | | Y | | Whatever is selected from the bulk request or from the single request for the label. Should be the value service_code from the getRates response |

Upon successful request we should store a Label request with all details as described in the getRates and add a record for the actual document label as a dependent table in the Label Request (table: Label Request Document . File Name should hold the path to the document once we download it and convert and store it, where Document Type should be set to Label)

More on what should happen when a label is successfully requested please refer to the Label Request UX section

Example Label Payload:

{
   "status":200,
   "data":{
      "tracking":"1ZE7A015A693956147",
      "shipment_date":null,
      "rate":"50.03",
      "carrier":"UPS",
      "carrier_service":"02",
      "packages":[
         {
            "tracking":"1ZE7A015A693956147",
            "width":null,
            "height":null,
            "length":null,
            "weight":0.5,
            "options":{
               "Reference":{
                  "value":"ORDER-IL003"
               },
               "info":null
            },
            "labels":[
               {
                  "label_format":"application\/pdf",
                  "label":"JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAyIDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlRGVjb2RlIC9MZW5ndGggOTI+PgpzdHJlYW0KeAEEwL0JAkEYBuH8q2IqeG\/25HRNxR80E7YDQUEQMbL9e+RW8i6z7PiXUbmUUXnVYTCdpbUo48lp1I\/NbFRFZNkaVTGqMveWvld5fJiujeOXe60BAAD\/\/0SQFNYKZW5kc3RyZWFtCmVuZG9iagoxIDAgb2JqCjw8L1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUiBdCi9Db3VudCAxCi9NZWRpYUJveCBbMCAwIDU5NS4yOCA4NDEuODldCj4+CmVuZG9iago1IDAgb2JqCjw8L1R5cGUgL0ZvbnQKL0Jhc2VGb250IC9IZWx2ZXRpY2EKL1N1YnR5cGUgL1R5cGUxCi9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nCj4+CmVuZG9iago2IDAgb2JqCjw8L1R5cGUgL1hPYmplY3QKL1N1YnR5cGUgL0ltYWdlCi9XaWR0aCA4MDAKL0hlaWdodCAxNDAwCi9Db2xvclNwYWNlIC9EZXZpY2VSR0IKL0JpdHNQZXJDb21wb25lbnQgOAovRmlsdGVyIC9GbGF0ZURlY29kZQovRGVjb2RlUGFybXMgPDwvUHJlZGljdG9yIDE1IC9Db2xvcnMgMyAvQml0c1BlckNvbXBvbmVudCA4IC9Db2x1bW5zIDgwMD4+Ci9MZW5ndGggMjMxMDQ+PgpzdHJlYW0KeJzs\/dmWszjWMNx+sUfe\/y3HHn9GlV+XAaFmqcNznuSTDlADGJaFmv\/f\/wMAIJQACwAg2D9\/\/\/n9\/Z1dEgCAvf38\/Pz9QwsWAEAwARYAQDABFgBAsH+Ktn69Wbzy6sv1t+Vp167jn06TPe57lftHpnVJJYqauVlmCokEM7O7zTRzg7p8AYBb67Zg3YYmsSkfP8zcbHCpHpMvADxYWQvWaXNLVGvHMfGfn59j4rfZpTd4Dx0STV+ntUuUKqcwiSOWWapws\/KFByi6FbzvdbtNRcPz7S6ZLwpyVFQ8v7Sl95+\/pAJrx63wp39RpglF5RlQi7IAa5jf398ej\/mrA\/rxv4nNKmKsIu\/J9r52M48G8O791jTlSROoOu4pDe+m2KKQewl5LicSGXOOhjUirPuK8I\/WFGARP\/+6+tPw4sS7quBt7bao\/haFXFnv6Cr9FYsy8jJYPcAKlPlbM73ZY96j7f7LG1az+z3hJd1YtbUn1WWwAdFVbF6DUz61eoD1JY\/\/97jNLQAW5IuZ8CU36q81MroKzHFAmml9+2BV1yex4+2cAg+YdCB\/hgVgitPG7NLemRO\/47e3zdPPM\/cKLFhdV6rE9Df9etA+VafoKn8mpqNOg0vCLdTJ\/QGBUYvjWBg3AliE7tKntjgOnYZMfYlOh+6qB06nJ+CsC6BvgFU392Zi3\/ZpGhb3EWaJsWBxz3h+P6MWhPu4MDa9TmbVYqE+WL\/\/9fe\/O57FKIIq+BKLdLtcoQys6fU8qn4wrdAA3F6LCgsFWL1lHtZ0hDds8N3u6cN3quvJ+\/Nf3cp1kvW7or06F43lvLd99M6oa+KDH3wL9cF66T2fp\/du7xwNKNL1+7LCAJeP6Y6vFrrY5b6xQvMJsfLXHZ5r0Ras3vOkH8eV5Cwa06\/56vi7cMDPxMyjAURZ\/5uVvzrZyjeKisY5CLdiC9a7Y\/tK1DQN6S\/eeytaTmohoyArUhhzNIAQmb1rJ7YrX60Am5jHYbVmg4SNisoDLNqC1W\/O9Ku3sJm\/2wYsQdg7r48sZmUN3+n3zOxC\/Y\/ShZN3+Xm22nHm8epbsNIXa+Kv+U3QpYsQ539\/Sju8D9is9Ms\/\/mgAnYwf\/Z5u6r5qx9oonPrgLsd4q78iBFhKp5dic2cYys\/9NMxa\/0Xh+iWkfZrM1az7ihBgO7vc+hstXs3Td6+btr09wNeeiMoWrPyBr4mRdxWJVCRVOp7zagRySxmKtgEAdlfcgnU68DVzodCKRG7H2cYOxM0vw8eSSbfVKTpuwC7qZhZtTGeYNUuV72vbThZ3+jR8XgNEQCf3q0lBcy7ldCKnc1NdZdHehfy2wLdVvt0gcxtgKRXL0F7dnU7byKc\/+G8jP7cpWhw7+U2\/5gcoDrD+DlN6qt+cSOU2kY\/tbxPMKHul21lhcqpTWmVgZem5DG77gId\/9+v6Qly57QLRaORM3BXBMT0UPfKecY5qOrnnhztFkzV8uJ02PXZe9cbbR04ZnnHFwHca+f3d7l6xV4H9sp0lduaj9XUcRbjjMcoss+8n8CHqjjf9zhk+J99065fwe9x25nnSyQqYB6t02t\/8RK7eteVv8L5YfaJsRZ0MclrOMlfDyMkOWERips30fem9Ub\/03dxIRYvkTC9tCy8KJ\/qeIx820WjIIct58Z\/oCH+6wdFtCld7pYt65L0hPE\/ja46Pm8\/0O8DcHq7D6PMaZdb1EJvvmFq0Blghl2z+T7rb347pruXvDVql6\/Acy1zXezR\/G+DZWu7ye73I611Tv2ZZUFMfrJBu5hWJ3EYnVy8Er+b2zfxyfswOfDVp1jHfim0AgH3VB1hjoqt+zdctbUiJwdi3pRJdAcDjtS6V07vtqrRDVb73V\/JXc6wXpSy6AgD+1LRgzXozuDLRFQDwUtyCNSy6erUwvdqoPva63eDYEJW\/HnNiaYtjBy\/RFQDwrn4UYb\/pr45zxtzOknW7IHRjOTMTyTkmIccNAFhZx5ncQxwnU0hPr\/CxwWngEjK8WUgEAFzx3goAIMbrPdXqLVgAANsRYAEABBNgAQAEqxlFWDcOLj1PQc5fq3c8lrNlHtFjapkbJ+aPyNk3kWlihONtRjmDHD\/mZa04EQDwVcJasH7+lbll9V977Ngiv9Zdy5D54QCiKwBomgfrOBVnYuGaTs\/7nMae2JaVolpXr+FzzCKnqSy9CnV1Gd4\/vEp5epQJAEuJacF6n32q\/Vm7y9M6ttYV3sOvj9m\/urYk7XKCAGCWoZ3cb8ORunhlbpTDi\/eDAPAnMsAqeo3VrlOypWZlPaVT+cj3vwCwry4tWC1P3H2bo7YrcIuvqiwAlKrv5F7qOB1AeK\/zwGRDhCwy3akkpdvflnydww4A03Xvg1XR1JHTiKUFZRaBFADcGteC9ZIY7b9gsi3WiUVK+07ll3y1Yw4AK+gSYGU+zhOv817R0u0rv6Jku1onnBrj\/Th\/W90BIC3yFeFprBOYfu9k63zhnOnCKQBIG\/SKMGf5vOMur0aswGSfZ6l+\/QBAWAvW+5J87Ssov1THDWPCrOpaR7kaDTBshcQvDGcBIEd9C9bpw7VoHb3GfHOSfS\/k379PS\/hym+ZtrdMbHyeVKC1AUcGq3RYsfJFHAHiSsD5YpevfZU4oWvrwHjxPae9V\/6oLIOgBgIk0QgAAxHi17wxd7BkA4BsIsAAAggmwAACCVY4i\/OhCnj8fVWLLzBF8+UP2buWsrvOXXTrrdAFKC1xxiG6LV1f+2wQzt8\/ZuHTdno9jUnrwAaCr4has0zmWqofsmUipSL\/DdZpyaXZF82+F1EX8BMCa6ufB+pgQ4XQ+8bomn+ryJFp6rv4UPnFX9bwSVwbEoO9ZFM1zcXr0rmaWP278sZrh8fhflUF7FQCLK27B+nuGvT\/JKp5qw6Yap8jHaS2d2Cw\/OAuc7h8AFlTTyb29neC93aIxqS8xeALVYVqq4+IBYFkzRxF6QN46fXm3sthCpru3A8CyAgKsRJ\/3nzcf22wRLnyJ9+axqPAlM53My0BQBcBe6ju5f8jprP0NQVWPUPI4o0HXI5kzp0NIFi0yG7e+4ZIDYEGtAdbVFEfvQcDt+LJvlogJRjbbHGeTCj9ZddFPzlxlALCapgArMa\/BcZjhlzwmu0aQvaONjzPVNSCuSzldfeE7AIuoD7DqZo3SiPUh52ic9nLrGvr0eIWXM3FawsekWY3FA4CuKju5V8\/J6dGYaW6DX\/Vp6lFs1wwA26lpwQqZ8ZxM+es87uLVQqY5E4CnqlmL8O8f6ZWAP7pL7x4TLCjwkB5PUEXi74nchk09OmABwDoC+mC9O12c7vSvgfmejoDr0cCWU6OQWlf3b0tnnd6gouS318CtVyNW+vSlF5pMlEcLGQBTdJnJ\/XatX1qEz+MQdb6Kli986uI\/APD\/Pd3+\/iP6AQBo9Go1mLkWIQDAIwmwAACCCbAAAIKVjSK8GsmV8\/ntonuZo8NuV\/lN9J7+GLCWSOqqMC1LBxaN6TtuVlHaU0VD\/64qlT\/AMGdV5tvBmDnFq04EAMJ9dQtW0fi1q9m86gbBVSTVdbRd7FxlpRW5nYXrdKau9F45iQBAJ2UtWC2r1GVOZRQoMMdEC9npAnmZ7TfHXYZNbn5a2qvc21vITv\/63qB4OiFWzjLhIYkAQKyAFqzjFJEfYiOGq\/aPfpODv8dDH7NfBk4imvOqsVOU8F6RliyKmohuV25ObHA8hhWJAEA\/rYs9vwx4gMVmsddEl1uUNj+aEe4A8Gwd+2ANDgU6ZRf7WjOd2twoKiroqU7nqiWytKvcI1fIBmAvxQHWam0PLe8Ht2gWehlW2pb0Ay+Pn\/+6Sjknr9tEAKCH+sWer3x0lO7xSBvWEzxRgPf\/ffxjO\/yN8PsZPE28\/QiHJAIAdepfEb7Gbb0+2a4blkas8d6rkD\/zRUV9QxIBgDoxLViz2gZa3g+2eECgU6TrEb6a++PjINc1W4YkAgClalqwMvu+VJUnV2D6e0VLA0rbOwT5\/V8f+ebPlV80n8VeZxmA3XUZRdi1T\/HgFojYB3M6tbl9sZeKPKqPQO\/+fwCQoynAmjIb1kfuITnu1byxV2lvPaMWAPAuoAXrGe0EiVp89Mt+fV4XGdy+8Mo5nuGT409pPEvke3qcjxOZvi\/yc5p+IhEA6Cd+moYrx6dd4pn6J7H+SdESN+3NXe85tre4vFKb2ARYtKhRbDnTqSUOzm1q7xFYUSIAEKuyBeuRzQDpSt2udteeV1FS4QsHzTqnOTOIHot3+klpIgDQifcmAAAxXm9OOq5FCADwnQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwf7pncHPz8\/7\/\/7+\/mZu8\/Hhh8Q2p1lkFu9WUeIAwHeqD7ASocncKOS9YL1LsuxBAAAmqnxFmG74KW0W6qdrSW4PwjrHAQAYqSbA2itu6FTazGT3OlYAQIjiACsnYgh5O\/b7X6efFyUVHuUUJSjGAoBv09rJ\/SPW6R1MpEOr979mluSY4G0XrmPK6UQAgG8TPIrwC3t2n1b59\/f3Pcb6+fm5Cv6+8IgBwOM9dh6sZQMXjVsA8HiPDbDG9G1fNowDACYqfkV4fPlVFGd8T\/vNx4ECAL5HTAuWOZ\/yafQCgMer6eR+1TZT2poV7irIWy2mWa08AECsyhasRIigKQsA+HL1rwgTE34uFWNpLgIABouZaDQ\/osqcujOK6AoAGC9motF1RsytE1EtckAAgPHC5sFaIbIZUIbBSwMBADt67ESjAACzFL8ivJqL4Wvbcj7WGcxZDdpahADwbJV9sGaFU8doZrxjh7Oio\/G1kSgAfI+YTu4fQmKgq0Bk+nSmpZ36p0eEAMBg8X2wviSeyKzmlxwNAOBdcYCVjhi+Kp64PRSnG3zVIQKA71S5FmGHkmyp7lA4gADwbP\/pSOSRDwDQ6NVFu0sn98Fup0W43ato7erSxHP2KprZ4ai9vqfpN5a5cXsA2NfeAVZipGHpwz4q8dJZGMbM2pDIJf2norUjo7YHgN3tOpP7z7\/SG1T8qTHxTtFVvyAs51B8\/G\/RkWk5TQCwr11bsD5mono1hJRGDIGJf\/z1+I4v\/dbvdvvTzXIkiv1e0\/eU33d5L0npkak+TQCwtV1bsF4+ZkO4ihKuPglM\/GPH209ato91nFHiNvfSI1N9JAFgR7u2YFWEIB9NKe3dxhOJh29fV6qc8KU0zd7bA8ADbN+Cle\/9PdeAXDptX+T09R8A0NsXBVh\/hBqlHDEAKLXxK8IKnWKF49C5dL6l21ds2dJ8pVMUADR6WoBV17cpMPHT6CQx4VPp9plblkZXFRONXu3erwsaAOzi614RdlU6AWnIhKUanABgNY9qwVqk+Sp\/DoLM7f\/GPCbeM378Napv+7F4ic3yc9R8BcDjPacFa3p0dfrXnAmlcrbvPVHW7\/96\/1P+9KqiKwD485AAa5HoKj+dkO1Del\/lp5zIS3QFAO+e8IqwayekfXs43a7GeNsUF7uM4L5HEgBKPaQF62WpSUS\/x1LTqwLAdNsHWCu8HMzMt3Qq+aLe5YN5OQgACXu\/IlwhujruVVSS2+1LE8yZcOu1TekEXYmkEkRXAHybjVuwFoyuPvb9+Vf79qefB3a9TyfemK\/oCoAvtOtiwPlvx4padFoST+91LEbm9jmFqQ50ShMvPTLtpwkANvJ68G3cgrWa0k5a7Z26KjYuJe4BgAp798FazWmzzW0gld4+0RTUHv10TRwAvtaurwgBAFbjFSEAQC8CLACAYAIsAIBgAiwAgGCPGkV4HA2XmH0q0a8\/Z5uiKTQT00HFFuMq5dv5qIqmqs\/ZN38oZWLjRNWKlgk6PRTtRx4ArjwkwLp63P59PuAxWbqgzfuOuzzI0wd5l1oAwADbvyLMXI6mR77LptZDYBtYacoAsJ2HtGC91K3rMkyP4h0nC42aIz4nka4HOVG19NJD2tIAmGvvFqyPZ+pxDvSRD9rSUGNw8aLUHeR+DWAAsKC9A6wcPZ7cPRpLFmxvy+f9IAC82zjAWuGVkHYXAOBo4wBrQd\/QHlPxJrRuRwDY1xMCrMHNSJkTQZXaqDEsKlQyvwMAT\/W0UYT52qOExrBgndklciryMbfnRtN3XdGiBkA\/T2jBWkr6sf3z5v3zLSKV05kRcsIUbwkB+DYCrDI569KU2iK6+pOzKk4m7wcBeLDvfUWYsxTd3GKsmd1x8s+WlYImWuQCAOCRvjfAapdYm+\/q4X18WbZjaHIaZm1aEQDo4QmvCIe1NwRm9IxYJL8WH5Gl94MAPNsTAqzdeSEFAA\/jFWGNq3aXohd\/HxMfAACPsXEL1nsEMyBS6ZrF4pFWSPGO\/c+8HwTgqTYOsD4c52Q6nXGqq9KIYaMI4\/RgrrAcJAAsaO9XhMe3bAPCqcxIonRUXWL728m3Tg9C0ZxV+UUd3NiWXzUAWMf2LVhjnrX9oor2F50rvF7sdBZWqBoAVNi7BevP6dSX73+iUdQRfm9xdGoAeDBPOwCAGK92hO1fEQIArEaABQAQTIAFABBMgAUAEEyABQAQ7AnTNBynD0gMiiyaayBq6oeiEh53uZ0ytNMGmcW7SiE9I8NHCleTph5lzhzWXqP8pAKLAcAz7B1gXT3YTmdFTzwFj9sXbVxXwr9\/LPIAzq9UukYViXSdpDQk8ZakTD0P8J12fUV4u8hg6RI67xsUbdyyWeK5G\/hILlozJ2Hwwo4hAgvcUv3tjhsAjXZtwfpYhfD2BdPVHOIfcdXfn4o2zi\/waTp1juHj+DaS6hplNl\/NOrz5bZldiwHA1nZtwXr5\/df7\/77+fdpP6OPxmX7A5298W8h0yml1rU2xu3xERdU1GvBysPTwFqWWf2BjiwHAXjYOsEofYP02rjPx6dspylntCP8JaUl6xprcAAyzcYD1eCEhSDqRwc1OggwAvoQA6\/\/0a4CJDSze+4flz25QlHIPA14OAsAivjrAKhoX1jiGbp3Gm4pJuSq2TGQ6OLqKyq4xHTElwFfZdRThlaLZNdNbtk80+jHUsXE6pfbJt47FqyjJMNUHf5FYdpFiADDF0wKs1XzEWKVh1nH33nrM+DCgConpOTplVzS72OKxLADhHvWKsPo9VNd3hVHzfN7uWLR8ze2WD9CvUmuOlwRgHc9pwaqbvjI9d2jRxgl\/W8bODvrad3wrV6PMij+jz9MixQBgsIe0YFW3XY1sijhO3FU9AXqIn\/\/VL6Pf\/9o6i42KAcB0TwiwYpdGCdy4UwppRe8QAxNfRL\/D2\/5eGIDv8YQA693zHmxR6\/OsYHDTziLh4CLFAGCk7ftgfdX0ladLUL93w2qcoOG1+5TVo6P06JRWkeB2feMACLR3C1Z+dFX04izkLdtqD9eW8gS2PO3YiPWRSEXoudrFAEBvGwdYpW1Xp9MrXD35ijZO53g6D9af1VqJ8pcmPFYqf\/aKATFW4IFtia5WO78ADLPrK8JE1PIhf+Be\/qxRg9cirHjZlD9RxZWPt4RXM6b2EzVlV+nrzqiT3lgMALa2cQtWrPEtE7G916vfkDbm257UgEasidU3ZQPAd9q1BavU6VSf73+q3jgkx110qtTirTsrlw2ANZ2PSgMAoNSrDcIrQgCAYAIsAIBgD+yDVToK7Lh9aYfx1\/Y5vZhv38a2j2IrrVHv8vRIqj3H06xjD121uhGUUX3jKnKfmHVmCjlKv5t118ZVIl1LDoz3qADr9g71t8GyN6N+5a\/rRZ5Znsao8X2DZU\/NMHVP2fTUuF2jk4lZD9Zj0lrgwZ7zirBojvUFb3NR5Y96DBSlk9543+nvR6q+LPPj4PDcJ2Y92PolBFbzkAArcB7OKZYqf+yzpGL6+8DcdzFr1tYBuU\/MOkpUIbeoLBDlCQHW7retpcpfV5jb1aMHlGFfLfVtP1bVKUzMeqQtCgksaPsAa6\/bX9FqPBV6vzosssWpWa0ts5+Jp2OLK+FUYMn3PQhAnUd1cv9wNTyn3zM1dqLz8eVPPwMCV325HTkVNbf7+vPpZ46sPN0sUa\/ME1Sd+8SshxESAS32DrAyB3UX3ffb5a\/NvGb5b8vzUaTMyS9OkxpTtYrVsue6OuD5O55WOTNsrct9YtYV29\/OxzG+J+KUSViAfrZ\/RXh0dbv5\/dfw4hTrV\/667saJTEuLlKhafnkeL+oqbV+desesQ3zttQcEelqAdXuPXucmfqql\/D2eCoGHa\/EjP0VLa0SPPubVjSjDsg4xOH7SkQu+08YB1u73mqXKH9tLqaJqwq92E4\/h7qdv3x9myxYM2DjAgoeZ+7AUn72c9hSss9TvKGCkRwVYq92mS4WXv\/esEC0lyfHsh1N6To2XliwSF0Dv3CdmnbbvRbVvyeE77T2KkJfwTi27R6ubupoQYczpmJj7xKxPs3iNhVy5+cqXFFYmwDrhl+IU202mEC5q4eTtcp9b8SvCF6DFo14RwoPNjT6fMeHnyFrENip\/+W8P2JEWrIc7NgvVNQnc3t9vJ2en3cTmnLm598t632aqfUsOX2LXFqzdn+K954kuuvnufjBhNeZbB3YNsACK7PtDYt+SwzfzivAbzX3TRNrtKstdz93E3HOyzn9VXZpjoAHNV76\/sL5dW7B2v78Elj\/2kdNu91Mzl7lGn+fBVQMStGCdSN8Qt2iuLyqk+REWcbzwRp6aibkPyHrYYQzPyHcTNrVrCxbP40HCSGMalnrkokkMtqAF60uVdqb52FgwBEdX89Fn7iJygifRgrU3gQ4Jz5gdtN1ShSmyb8mBRwVYu9+Mlir\/Cj1g\/KAPpxv7n6UKU2TfksO38YqQJSwVXLIs4QWwi41bsE5vtRs9p6eX\/7bzR3VhpldtC8ejVDr2c9buc0teat8Lb9+SA1qw9nZ6\/038xK+4X4+ZkrS0It\/DAs897Htp7Vty+EIbt2Bdubo1\/\/zX8BKVaSl\/j\/tvYPep06TWPyMjvR+Nirgzvfvt5dGS+8SsARa0dwvW1WyEu\/zuX6r8iakdA8szpWotmXaNaE+PeeP1M2b3uSXPN\/h6K4oj07v44QG7e2AL1kSJFqbwxrOQ1D4SWaeRIKokI88IW1jnIi+1b8nhO20fYO110xmwCmzCLosSjizn9Bhr2OLEp\/uOyX1i1gCzbB9gPeDmG1X+kHRiD2ZFarufzX7aw5TY3CdmnWl69Fxt35IDL08IsB7wVJ5Y\/t6NahoqbuXUOrHNxN3nlrzCvhfYviWHr\/WQAOvvBjT+fh2oqPy9f+BmFiZz491PzQDpQ3R7ZG6Pf7\/cJ2YNsLK9RxEeXcUfu9ype5c\/MVTwqjBR5blKbZdTM8Dx7BeFuX\/\/eO1eemCrc5+YdcK+b9n2LTnwrvKGCADAh9dvpOe8IgQAWIQACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALAAAAgLVpwQIACCbAAgAIJsACAAj2z99\/fn9\/Z5cEAvz8\/Lz+7aoGYLDXY0gLFgBAMAEWAEAwARYAQDABFgBAsJgA6+dfOR\/m796YUY80exRpl9wXLCcALCsgwHo9+d4fgacf5u\/emFGPNHsUaZfcFywnAKzsP0+s6gHtx2fe7+\/v6Yf5uzdm1CPNHkXaJfcFy3ma0TE70zQ0yoloKw5yItlOp6xTRaLKsMKFunjxYCOvb9M\/s0sC62ppM\/t4LKWTWuoZVlTrn5+f\/MJnNnZGHY1+FYktQ2ytSw0+Kfm5L\/WlgAo6uQP\/p9972PyUQ8qwwgvl0givZ1laM+1RvBXOEfTTGmB9\/Mj4+9\/TD\/N3b8yoR5o9irRL7guWkx66jiQoTbmlJIsMiagow+Bijzwp8IUCWrBez7z3h9\/Hh4lbXuOWPXLP2T0\/98YPG3NP1KhH4YeVk1hdn511iY\/cK1x1MYaVf\/rhXeRMQT+tndyz8sjud7zglvkf9tCY+4KFz9+yrpyxtfuSPliNj7r8kxue+MS8+hVjbo\/7HCHFuy2DH1Rs6nVtd++D9fEtSnypFtwy\/8MeGnNfsPD5Ww4rJ4sf27mdhGZZvC7txVu8ghBCJ3egly98jq5f5fVLCM8gwILvtcWzNn+mgydZvEaNoxBCywKL6h5gDRtR2GPLuePa5o6RbLRLOb9Z7+fc4v21e1inJFfWLyE8xoi1CG9HgZ1umR5rfbtlfu6naaYzqhvXVrFyX36RGmtUV878wleczRUGD1ZnLSKknWAIthYwinDuSLdhA+Ua05w7QDJ\/97lptp+4TmMk8x91iV8RFXv1U\/TwPhYv5zjnZPGaj6OiDPm5JBIJvGAyS5Jf5R4XxpiT0liA6sRhBWGjCOeOdBs2AK0xzbkDJPN3n5vmyiMHc+71v\/8aUpxxrir1+19XO+YMwh\/ZSFldkfBipMvT1WonBZ5NJ3fI8m3Pm8wIIOqwdO0OOLIiRVncZjr3Z8aU9jN4DAEWfJ2cloyuBYh6tTS9IvnWKcmVru\/74AutuBbhggPQGtOcO0Ayf\/e5aRo5+OW+84wvXuspHRnhGQatRXiqdEW8nNzzV68rHdPXmOZpOXMyCtkyf\/e5aer\/sYL2g7\/Io3TkVbTaIIajRU4KfI+AUYSVGU8d6Lfglj78+LBOp1GEx8SP8k966b6xBpSkOouiHdc5pO2FecxJqUukJWVYTdgowsbsT\/+3d5oLbunDq+MDADvSyR3Yg+B7QTknxYnjOwmwgP+Y\/lJm\/UkfvpCDCXXmBFhzB\/otuKUPr44PsR7TlvCYijyeM8XX6rgWYXrL9\/FipUPVrhKvHnuYWc6oGt0OnMzfMv\/DYblHFf700AHAFgJGEc4dPdfDsBo15p5vWO5zC28U4a3MYtzONlKdRdSBGlCRIouPIhxzUuqyrksWlhU2inDu6LkehtWoMfd8w3KfW3iipK+QjU7BYyqyr5wXDvBU\/8wuALCEv9e7OVt+vAIuzaVir9IsBlTkSRwB6MEoQuD\/tTdYruMxFdmd5iu+XJe1CPO3XHCs2bAaNeaeb1jucwsPy0rHcCI8eKT4tQhL1+OrHmsWNfZwSo16rMeXX87E7vl1ry584\/qGrOMxkcFjKrIOhxQCRhH+T3JTR6v1GHvYo0Zzy9mjSHPHXdaVpMLuowg7PfM+Cj9gPN2YipSqq3hOXXqPIuwxyDHn\/eAKXwoIFzaK8DTR0\/+t2zJ\/9x5jD3vUaG45exRp7rhL2MLpNfzUC\/up9YIiOrkDTR7zNO1dkY\/34I85bkW0S\/E9TNMAMM7j46rHVxAyRbZgzR2t1mPsYY8azS1njyLNHXcJi3CV3nKI+CrBaxG+D\/hqXDcwfzm\/ig\/rMmqse49yvuQf+boi5e+ezrFu0Kh5t6eoG1uwoMdUZH0OILwEjCIcNiZu7ocLljO\/SI2Fb8yoUVFGRhFWl+HlWJiikW7rjCJsrEiF3sMbK9LPOWKBowhzfgRWJAsbCRtFOGxM3NwPFyxnfpEaC9+YUSPDCQc7fart+KibUpEdDxTQiVGEwL3HhA6PqciCipqv4PEEWMB\/POYpOLEijzmGQKMuaxHOHSTY48MFy5lfpMbCN2bUyHBCtvOdV6nX9\/Ch11qE+cPKctLs8WG\/dQN75J5zPEsXE8zJqHT3q7LdalxIkeke83wNqUjRtfr4C\/vxFYRTAaMI\/ye5USPLGg0batcj9x7lnDuiMPCyMYqwXxluI4\/MIX7tB2pMRdrlD1rMrFGnUYTtJ2VMeL3yMwVewkYRniZ6+r\/rGDbUrkfuPco5d0ThLpcNmY+39Z+Cw0r4+6\/GkoSUdv2TAs9jqRyAjgQ38J2MIoRv8Zgn\/WMq8kerLTzSnLUI5xo21K5H7j3KOXdE4S6XzeM95jH\/mIoAW4t5Rfh3R\/vrcPD69+sfp1uG5Fua5mk507uc1ih\/99vc0+nkH8\/TDQKrmV\/OHgekx2XDgsRGaVO+Ak4K1AlowXp9\/Y7Py48v5+mHsbmXljMni9Ma5e+eyD2n8PnH87RIIdXML2dORonCD7tsqPCY479RRfyogH2NW4uwx2CxXUa6zR3lN6ycPTIyxnAXA0KBMdHG4Jhm90taCAhXdHIHhto9pHgkJwXCCbCA\/4h6yk5v1dglXBhZzuknBb7NuLUIewwW22Wk29xRfsPK2SMjYwxjVR\/AAaFAURYrVyTTbUlWuNrXOVywnYBRhDnj1zIHo9UNCTzN6Lac+aPV8jPKzz3x4anq3RurmX\/o8qWPZ8tRot37epRb5zKmItUWDFxajljdjumDsPLpgxz\/ub67Xsrv36L8Fa8qtuyxe+OHc\/UofGM1ex+6rmeh5XmwzrMk59F+GnzH7tK4\/bCKlMoJUzKjq8EXcMhJCSzPIndRKPV\/I9\/\/\/tPvUj5+ha7yatyyx+6NH57mPkyPwjdWc8Ch6xdgNT6be7RYdH1N9t6yWFeS2FwGZBFyzSSuwDHvQNMGnJSowky\/hUKd14VtLUK4kf9cXPy1VJEx77BW69r1mKxbbFpsWI0ACy5VPGl0F+vh247nFvXdopAwUfdpGnoM9Bs2KG\/rwW49Ct9YzV0OXbvF2wBiD\/JVagNO5ZiKPMk31BEWERNg\/fzr6q+vr\/Rfh5vjlq8P37dM53i65W1G6S3rPqzIfZjGar7LP0dRRx7+fFtMsEV9tygkzBXQyX3Y0L+5RRo2zq6HYQMkp18MsQe\/JdRr6eBcl0WpkCJFjZibm0Wnm8\/EYqQNOCntxVjk5gmlXhd2l7UI87fM331ukRrTnKuxmj3qPuxiIKH9AbbIS8AtKpJjkWLc2qWcMJelcuB7LRIh7ZJLVyOr8IDDBesTYAE18h\/S1Y\/z7wnOxpdh8ZMCD9BlLcL8LXuMIBs2nLAx92GGDZBc8GLg1u+\/Kvbqun1dFgNy6WFWGTY9XLCLgBasj2FliVFgp1vm7\/4hP6P8wpd+2Jh7tdKjlHPkP\/5dd46qtyzdnVhFzVF1F\/aALIblEmV6GfY6XLCX4KVyhg0iW3Ck3jBzD\/Kwc1S3+zdfGCFypthYP4thuZRmPaYAFSYeLniY17cpMsBqXNJu2Ip4W5t7kIedo+rdBVgATBQ2TQMAAB8EWAAAwfTB6iizg3Zp+fXB6pcpALQI7oP1vqLcx+pyOXud7n6bTnrL\/A9jBS6ucptLTt3TBzmd+O1hzD9HmfVq312ABcBEkQFWj4aKHq0svR+9gRMKtHToHtbstGYos2apAPgSE9YizN997mKCFcKna8pJcMHFBAGAPzq5N+k6E6aoBQA29c\/sAmwsZDrBdCIDOo0BAOH0warUY+Lj0jT1wTpas1QAfInIiUYb149rXJMuf+28wHXuEoVpeagndj\/NsbruV1lkbpnI\/TTNdDoJ1iIEYFPT5sHqkeaA1qzbOC9ERS4LzlllHiwAvk2XpXJ6jCzbYkRh+IP8qinrqqjDBg\/2yL1HkQBgLp3cC6Tf0+Xvkrn76eLK72\/xAIA1maYhV1F09fNfOcm29G0HABYUGWB9RAMhDS35aZ5umf9hWn50VdcvO6cXf0JjNRtPXNRBDiwSAMwV3IJ1OwatYqzZe5rp3U+3zBmlWKFH29LVcTjmddwsv+6nOTaeuLqDXHE2AWALwaMIbzJ7ypRXvd\/cZaafPznWqR5HPl+ns2kUIQATvR5D4wKs0\/ggM2go2j0\/zRzt0VXm3Aq3e+WUpPF45m\/ZeJD7nU0BFgATdZmm4WtVzztaNLNoTjgFAKxAgJVSHeUUTemeP+uVJhkA2MK4AKvHSLce49eKVMyMdaVur48C9Bg5OGyQ4PSzCQBR4vtgfQwB+\/gw\/der3dNbNqZ5W5eXlj5PdTnmZHq1QaLup4eu8cSV1vEq9\/xTnEj86sj0kzhxrz8VveRNbHza\/f\/2T4mUE1kkippTQllkXglFWSTySmRaVJ7GLgo5uR8VJViXBQzwuiaDZ3L\/v87zbxOOn374bu6W1Vr6iV9tfNqtu1S67o0f3lYhLTB3AFhW97UITz\/M333Ylrf73j7jr\/pRXWWaWZjqeCv\/dDSeuGFFAoBd6OReKeeRf7vNafhVGskJPgBgNQKsGF3nUBBCAcBeuq9FOGxcW+OWE3XqpNk4Uq\/HoTN4EIAvMWItwtMPb3dvXKCwYstApzHTu9vtQ5zWPf8c3Z64iuN5W6T85REBYFnBowgTg+OKds8ZQdZjy5fSHu5px91DRgvmZ\/1R9\/xzlDOmunSUX6JIOeUEgPWt2AdrteGEt6ktHgcMGw\/YuLuRgwA8xooB1u72Cr8AgHACrHimUQCAL7digPW1wwk7GTYesHH3bz5HADxMfIB1OrIsf7jZ35YfI8gSu+eMNStN87YVqr2NalizVkXdj7uf\/in\/yOcU6TTNYaM+ASDWEmsRNu7eI81Y7wuU5q9LGJhv4Ol41\/VsWosQgH2tvhbhpqPVilZ9rt6sKJF+S0MumDsAzLViH6wdtczGXreMNACwLAFWpZygJ2qbD5pzAGBxq69FuM5otduwpqJz1elfqxefSX8ecjqqSzU4dwCYa4O1CBvXpMtf\/O5qx9uUbzd7X\/UlsSJh+MLP1XVP7P5R2tLdGy8GANjCHmsRhiwFmLP4XUsut4mULoBYvc0x0+q6J7as3r3xYsjcFwAmWrEP1rC180ozymleqi5tv1a0uaM7e4xGBIDFrRhgraOul3rF+6zM6Ep4AQBbEGCVyQ9xMsOs6h5gun4DwLJWDLCGrZ2Xk1FOM9LtWjFX3cNvV6FJ55tp7ujOHqMRAWBxg9YizN8ysVBdY+6n69w1DlF8T\/x23Zh36aROd8\/Z7DbNxOjO\/NNReujyM8ovPACsLDjAeh\/wVbFl4+DB29yvBtCVzlZV1PJUJLbt6iPlY+KnB+SYb2LsYdFcFTkZ5RceAJbVfS3C\/C2HDTeryKgoxqqerys\/uoqNNvJPx6ZLQwLAYCv2wdpFeo7NotmerjYeEF0BAOHiJxp9qr\/5xD8+zJ9Z9GPfivmr8ncEAObqvhZh\/pbDhptVZ3T1Ci\/zJWN6kZxjspkFaJd\/OnqcI+MEAXieEWsRvkuviNdj8bvb3NPlvMriuP1VqUoVzVNacZROt8wZZpj4MD\/3ujQBYC\/xfbByehS9Hurv790SH57unsg9Z\/f8ch6zuNqrMcxKT1WQ6GhfepROt0wPM7z9MD\/30jQBYDvjOrk3DlVbau28iplF0zJbfW7LOWyJwGFpAsCOdHKv9DGr01G6V3t+8KFdBwC2I8Bqcjq08FRFc47QCgA2Ne4VYeNQtWXXzuvUeSh\/\/Zn3\/x22ROCwNAFgR4MCrMTqdfnL5OWMNWtcOy+xe7qCgWFWTlL51SxdYfB0y5wP35MqOnR1GQHAyka8IvxYve64QfrD293TGQ3b\/bTM+fLjs\/xyDvvwtCIjjzwALKV7C9bcFQZnLY94O63o70Fmyj0GYw4by9lYIwDYhU7uI2iAAYCvYrFnAIBg3QOsuSsMDtt9mB6DMYeN5WysEQDsIibAyl\/4r2KoWv7ujevcnWZ0u3vI4LscjesG9ti94nTU1chwQgD2EhBg5S\/8l792XvXujevcJZZHrK574sN81dXMr1Hp7tWno7RGjYcOAMZrDbB2GdTWWKP8LXuUc8Hd544xBIDF6eQOABBMgAUAEKw1wNplUFtjjfK37FHOBXefO8YQABYX0IJ1uvxczlC10gX18tP8KGHphzlpnuZe+mG+\/CLl1Cgk9\/xzlFOk\/NMBAOuLmcn99eR7H\/B1+jhMb5n\/YY80G3Ov+zBffpFe8rdszL2xSI1pAsBqIvtgzR1\/t8soxUZzx9\/NPUcAsAud3AEAggmwAACCRQZYc8ff7TJKsdHc8XdzzxEA7CJ4LcLbAV\/pJe3qxt81rrJ3+mF+jfKVDv27+jC\/SPmHri73uecdAJYVMIrwY7RXenz+ccuc3UvTzNk98WF+jfLFjrPLL1L+oSvNfe55B4CVdVmLMH\/LuavsLZjm3CUX547uBIDH0MkdACCYAAsAIFiXtQjzt2wcLDZsoNywNIcNqRs2vtIgQQC+UK+1CHO2LN39Q+nid\/kf9hi\/llPN0sUZc2p0qnHBx\/wahewOANuZthZh3e4vOy5+V5F7j8L3WHJx2HkHgC3MWYuwcfetF7+bu2bigmM5jSgE4Hl0cgcACCbAAgAINmctwsbdewxhGzaurcfwva3HchpRCMDzTFuL8NT77o3r8UUtUNjDaTVvi9Rjxcb0h6e756dZt\/v1YQOAbQQEWO9DwP6ekYln\/Mc\/jv52P92yOqPTLfM\/7OG0mokiVdfofa+P3XM+PN09P83S3TOOHABsYPJahPlb9shormE1GjZuccExmwAwhU7uAADBBFgAAMEmr0WYv2WPjOYaVqNh4xYXHLMJAFPMXIuwdDXAnLFmjQsUDtvyo3i3EUb1OLv84zl3SwB4kmlrEQauiPcybCnDxi3f9dgyv0hRJ65xSwB4mDlrEc5dEW\/ulsM4IAAwi07uAADBBFgAAMHmrEU4d0W8uVsO44AAwCzT1iKsWxEvrS73HmlWFP40zboPGwufLlvdlo01ajyeADDYzLUIS1fEy9G4QGFImtWFP02z9MPGwueUsHTLxho1Hk8AGG\/yWoTDFqoblubcdQMbM+rBqoUAfCGd3AEAggmwAACCTV6LcNhCdcPSnLtuYGNGPVi1EIAvNGgtwtI16fLTrC7nqdJlB\/OX3svJqPEoNWbUY\/he46qF+ccTAJYyYi3CujXpGtNMl\/NU47KDvXevWM4vP6PAg5zO\/bTwPXIHgIm6r0U4bFRdox7DIXvsnm\/u8L0FDwgADKOTOwBAMAEWAECw7msRDhtV16jHcMgeu+ebO3xvwQMCAMMEt2CdLj93uyZdfprpjHoUPn\/L\/MFu1UMCM6WLlH+O6orUeEAacweAFcSMInz3GmD\/979\/Q8BOPyxNMyejHoXP37JxPGNIJJFTpPxzVFqkxgPSmDsALKJLH6wFh\/71SHPBkW5zx+7tsjwiAPSmkzsAQDABFgBAsC4B1oJD\/3qkueBIt7lj9+buDgDriA+w8heVy1\/8LjGmr3qsWelqgDlbhtSoWn6R3jeIHcyYn3t+kQBgO8GjCHssfle3SF9UOYdVs9Gw9Q1vNVZTaAXAA8xZi3DYiniN5WzcfZca9WBIIADfTCd3AIBgAiwAgGBz1iIctiJeYzkbd9+lRj0YEgjAN4sJsPIXv8v\/sMeadBWL9J0KrGZF4W+LNHc5v\/w1KOcOugSAfgJGEeYvfpf\/YY816aoX6TtNLaSa1YVPFGnucn75a1DOHXQJAF21tmBZYXCAXQq\/yzBSAOhNJ3cAgGD\/aQ+ofvNybFEI6Sk1Mc0euTfapfCnuff4MLMM008cAN\/m9RhqbcEaNiZuWJoLDn\/bpfC7DCMFgN4CXhH2GKo2N80pg+\/Sdil8j\/GVC54OAEhrfUUIS\/GKEICJwl4RAgDwQYAFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFABBMgAUAAADA2rRgAQAEE2ABAAQTYAEABBNgAQAEE2ABAAQTYAEABBNgAQAEE2ABAAQTYAEABBNgAQAEE2ABAAQTYAEABBNgAQAE++fvP7+\/v7NLAgCwt5+fn79\/aMECAAgmwAIACCbAAgAIJsACAAgmwAIACPZPzkavLvEf8scenqZwtftVdo1lKM0lfGRlOsfGgxmSyOnuY05Hvunlqf46dPoelSZSl0Vm+kVn55js9JMLECUrwFrZ644c8pRqTLklx79tdn9mvNd0hbqElydxKn9+fuqyqN4xXI\/a9RP4DQUIt32A9ZIZoJT+wm4PfYpybHyMLfUUXC1knF6e39\/fissvM+Ueye5i+pmFHR1vR75EsZ7WByv9AOv0eEtkVx3PPcZq1VmtPH\/y2zi54vhAjp\/\/KvoTFZ4WYCXusy0XTUVc35LdrH07Wa1I\/cozpabDfnSudh6P1i8hTJQfPAmzQjwwwDo1vu1qegpLWa06deVpr0UiGJre+LraOQKieJ0yxTMDrC+\/LNas\/mqlWq08dbbuMzFyjCd8rYe9EtnIMwOsD42XSMVjYOvHXj+rfVef\/UZvit9\/RW0GNPI6ZaKdRhEWTZmTOZ6ufeanRMqZc00lOo21DF3s\/QDLr8gYvcuT33ch\/Kyt836w6GvVPu\/X1S4h3314vKhbh+9UnY1bsNp\/BF\/t3u\/n9Wmyj7lwc47byCBstfK8RJ3xx1w5pTSAwS0tT9NtHGD1FhvAjX8kzPp2rfbwW608acez5i4JlAq\/b7gRVdg+wBr\/Iqxi940e8FGqh8t1MrI8Yyo466Ja5z77hV8rYCPbB1jrm\/gYWOdZuLvwI9lpab86rhN4kk7faDeKUgIselmtgaFHeWZNNDDm2K52BoFbwqB1fHWA9Q0X4pp1XK1UdeXpNMZiEYsXD2BxXx1gQY7xMyD\/7b7s+8HV4mPgpetPI9\/9It8eYD1mxaXVOpX\/Wa0V5BnlWa0WABx9RYC15mRIi+ROo07hziJXxcrB3CKHCFaT+bX9\/V\/9y\/V1tg+wAmeqXe1+XXrF+4b0UD0deafLKfYsr1Y7YIDTiMoTJNz2AVas8WHWsv1sGMNNrUL6e+qQQuJb0PgF8TTJt9NahB\/Sp\/njGrpaGfAq5en36OreOa7+B5t+Wc7iqoYQ6XuIJ0isnVqwfv5X6e5FD6cxTVkjL2Vfm0DH8D0wteliazfYXqWFfnwXptspwMqXWMW5KJ2uQYmIZ30hsy0s63m180SBBF+QwZ4ZYCUsFWNdafkarDlfA2k5Z9zNESjyftNwAxnvgQHW7WW0wnWmi+7DPPusrV8748whwbdjio07uZ\/Kn\/8jv0UnvM9775akREfFFfrv7yJxmsYPmAg\/a0vVrtEKZYA1lfZb18890KNasComjhp\/ay4a\/Mj3cOqreR5AgnvLLA8JsFpCpZwdx9zBA78GemI9ifsjMIYHRKDtA6yQVqhhTVnf1vVqte\/qlPKsdhBiDfvtkf6SPvsgAzsa0Qcr6t7XOwTp\/e558DMg3RNrZEl29OxDtG\/tdBABdrF9C1asfjGcrlfvVqvvauWhgsALWEpTgOWOFqLf031u3LDa5bFaeagjGga2kBVguaM1+rauV7sLD8WWiu0eXLt1SgJP5ZmV72nzYC1obnQ1q8\/KajFlSHnWGXDaw0a10xMLWF\/3PljT74Njlm1O5D4r64lWq\/Vq5aEf5xqq+frEag2wqs\/H4GaMuWHWqWFHYPyhHpndrUXKs0gxOhlfO+8pgMXlBlh1M9Cs9lC5DbNiC7zaa7Kufv4rvdmwileX52qXolWYlvXs2v1Z7bYDfKeYPlh73dEqSlvxXImK5KJWsluha3PXx\/Nq5fly6d9dy17V8LVyvk3umUXmzIP1+JPkvs\/Xymk47P3K3hcQmK4gwIqKiraLrrYr8KnptZhegA+n5Xn2U39A7YqyaC\/PahcVbGr63emRylqw3M6os9qVU1qeou1Xq+ytR9bOAwNi7fLdX0fxK8LGQ7zdGdquwAmz6rLaMVytPLRwNqGRXyOd1PTBqr6jbXcr3K7Aq\/n91+xS\/J90eQbcZZ49Jdtqt+nVygN8lcpRhKXjdyY+Zf+yNsTsz7CBV6sdvdXKA7CCzCeCW2iF+mkaMgOXRc5KUZi1SJl3tNqhi5oOoGKXXZpPHlC7RHmipoQAKPWfu5J7EAB8FY0OPbyO6px5sAAAHkyABQBfZ6kX\/Y8kwAIAznk\/WE2ABQDfRe+rAQRYAADBBFgA8EU0X40hwAKAb6Fv+zACLADgf2i+aifAAoCvoPlqJAEWAPB\/NF+FEGABwPNpvhpMgAUA\/IfmqygCLAB4OFMzjCfAAoAn83JwCgEWAKD5Ktg\/ib\/lx7yvs5LYJefMve+ef6ZPM33fPZ3sx+6\/v79Xtfjb97h9ulS3Fbktf46P7PJzr0v\/9E9piZLcppBzgd3mVXd1XaVQeknfFumo+hpo+fpk7ngsedH5bdw49riVHoTSL9fpefG+hmE0X82SCrBi\/Z3jlqds0S632Z0afDvbpfwP+H42VuF095+fn8wn8QCxX5+KHU+PxlUWV5d33XFuUXoQHvBdgFOi+XCjXxEG3p7ymz0yE0lvf9tSVeTnX+ltFrncPVESbkPkZcVGV6d\/CoxdOh3MAdHV4pcBj6etdKJUC1bi92XOybh6SZcp\/bM13aSfmd1VdNXpLdtV8apfut1qL3lOSXJOU35J6sLc0ryKGkXSr3iKWm6u9LjGMr8+1VmffsHf8329bb\/6el4V8jbl9sJXHITYUCn2WwMsaFAL1m2w1XJPOb3tFqXTeCNrufNePWBWuLf2eK02RdQT6xiFp7MbpjS4fP27pZvXu0Q6mVFRRcotxkRX63wF+E6ar+bachRhyO\/v9ntfe0fp8B7oOVvmvJ1sL2ePamZmN9fgirdoKV7mviG\/l7rqHZKW7rLOlczuXEvTrRhglQ60qRD+FJxyKR+jpY9PEuFUfg+wwFafAW6zK726ql\/2zYquBnx90sZ8bUeqO6eNpV08OucxXGn9jBtFmFD9Bmd6G1JiToecfVuyHiNkOoPe0tn1eD94zOLjryNPbt37waI5R2JN\/2FddxDqoivNV0zh5eAKJgRY65zR2JJ0HUwernSYQr9cAi1y\/HvPwxTleAvOv4arr\/bbnzfV4w9CjnyP3vQVFrmSebzwDsS8GxRgtYwJDw+DAlP7aMRqKe1pwTKH1H2M1UrMobV+d6jj7l3nQFrzHlE3C9ppOqXTi9Qdk8xGxHf5kVxpMarjs\/fPQ8Ynrnl18XiaQhfRMcDKvKtebeYSybTUgRrfxbvu0b7UQbuS85hvrGBph62PnxM5u6TzDU+5Ijya3mtthdyBcEM7uVdPcdRJj+mm3CVnWe3qyvF7pjqpll3yr+GoLkr5TZVX87CEH7eQL3J789Wa1yq78AxaxxKd3P90aq4\/inqpF6t9dNvHJ+PfU4RPX1mUY92W61wAL3UNbCMreCzh+ye3HZgS377SlNP7ThQ1wRiwr44BVk7EMP620ulpumbQNsv46hfNXfkY\/V7SVexelHUio5EXT+NBOJo1ux6woKGvCMMfeCFTJDxvuqApHlado0Vigod50mVzOiPd6Ux1kwoIDDXiFWHOj8J0C8SY1xyBCQ64h1YMIRxjyhvJtJara6kXT1cqKnj8cG7LzfiUww9CSzHGZwr0Nnom948fc+mNczq9htybevR2z9mmPd9Fbs1zi1H3fnD3Zqe6Cvae\/6zfXMGB52vMJHAVdr8mgXeDOrl37XVx9TP0NtkVOk4NzrdHz\/fxUzO0N19VZxo4pP\/qKi1NuWXqtfbq3PawrK5gott+yHF77RV1ThMnIvG9W+Q3EhBuwijCkJDiI2Lr2rur6KVb5vvQToUvGlXXIxhqD6NbJqXsJP3yt\/3nQSLflpQTyba8yy4tcPtIz9K4JLOBauQLfeALjXtF+PFqrPSmFv5gOy3VVV7hd+HwiScCU9tLyPjBkLfVsdIpN1Yw3eesKOWWHfN\/tPQoRo+D0OKbv8XwSAtNNFqxS2KCwbr7bEgUlf\/YSN\/iu95wt76bj+wzl9i48RheneLAU18UQ1TnW1GRzLxONws8boEHoY7GM3iw0XNRAgCdDIvahQ1XXqdg9ChCAIDHE2ABAARbaC1CAKCFN3fr0IIFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFABBMgAUAEEyABQAQTIAFAAAAwNq0YAEABBNgAQAEE2ABAAT75+8\/v7+\/s0sCALC3n5+fv39owQIACCbAAgAIJsACAAgmwAIACCbAAgAIJsACAAgmwAIACCbAAgAIJsACAAgmwAIACCbAAgAIJsACAAj2z+wCBHgtrPjyWrv69afjataJPyWySKRzlLPxsaiJdBK755Q5p8p1BzOxe1EtinaPqldi47rTnZPXlCuq6DgXFXXAucgp4VHdraDuLBfl3vhtKsqibvec8oTfV0feZBq\/Do3bJDauK3POAWcwLVgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBBFgAAMEEWAAAwQRYAADBfv7+8\/v7O7skAAB7+\/n5T2SlBQsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAgmAALACCYAAsAIJgACwAAAIC1acECAAgmwAIACCbAAgAIJsACAAgmwAIACCbAAgAIJsACAAgmwAIACCbAAgAIJsACAAgmwAIACCbAAgAIJsACAAgmwAIACPbP339+f39nlwQAYG8\/Pz9\/\/9CCBQAQTIAFABBMgAUAEOyfnI1eLxQ\/HHtuHbd8bfP6U6K\/1+02Oelf7f63QX7KdV3T8o\/VcZe\/bSpSAACW0tSC9fOvuMLMkahFYO1us7iNnx5wqAHgS5QFWL\/\/9f5houkovNElM\/38WORjy4\/atZT\/eKxKI6T2FACAKSpbsI5h1vufPv4RKzD9j9DwPeVEBUvlpJPexstBANjL0zq5n3bJyt8rrfqVaHtLmxgLADbytADrXewLtVdqLcm2F8lbQgBYX32Ald87e7D85qii7UOc5lVUgNWONgBwVBZg\/bzpVqQmHwULLGdL36\/TYhSVbdkDDgAcZc2DlbBmg8rv729dRJKYZyt2WqyRKQAAg5UFWMcu5OnZOyd6xVg\/Pz9TipeO1dIfFqUAAKymsgUrPef4vuoGIeYn+1IxJ1ZgeQCArlpfEa4s3YjVu4mrPU1BFQBs6snTNKxPCAUAj\/TwACvzlV\/mC7uo4ZPPe7UKALyrfEUYO9lmThelTm\/xTnvrp2dVmNVrHgDYRVmAdRp5XK1G3GOAYUX66SkbPv46sm1JlAYAT9X6inCLKOF2KeXbhasDF5n2fhAAHm\/R5W4AALbzakZ5eCd3AIDxBFgAAMEEWAAAwYqnaXi9XLzqtnXVift2+9MNjkMFc7ZPS3c4S8wQkT95RNFwy8yKX2XxsU3REag++FcJ5hSjaPnFwPQzT1\/RMSm6WnIyTWxf+s06dXvhXW2TWdO6i\/k2i\/T2upACCyprwWqc\/mrxAXRXJSwqdqKagdVf7Uj2Lk9j+iFnNkp4put\/s3KUnqAHVBl4tvq1CG\/n2zz9gdt7ls6r5pzSTN\/nx3qfoCH9Y\/3jpv8xbWmiwaDlmHzsHnUE0o4zsl7Voi7fwPTTJ6Xx4N9eEkV1yTxcUd+sol1yalp9PI8pJ06Q0ArYQk0frIpgJec101zvgchfaX\/\/6\/S5ko6u3qv8Sie8zNPfjHSqV2D66ZNy3KaukB\/\/uNos\/FhVf7Mq3tIGTgV3lfLHCSotHsBSCgKsqOfQdioCytItS99CFpWnt6hIpWv6i1x+PY7VIrF7Y9X6fcsApmgaRVh6J3VPTIhd3pEcvUPDYSpeDn78I1bv4+lOAqyvOMAKubUt+Dx7f9ZWFK+ls1dpXo07hus9mKs6\/QVHmQ07VreqB+GWphmr91tpgCi5ndyPPYUXDJIC9Vip+jSXjz40FV22Fz8RpWPvV0t\/sBWqU5djxcWcTq2lMADT1Y8i\/NN7VOBIx2Al6iHxnkVOvnV5jTwRwqZ8i9cl9spZP+IHGKMswFrqwdBD0Yj62Hz\/Ms3MbrUTkShPSFF7pz9S5uQm40UFRqUXc6Ik251cgJesAKt3l9jVRE2VFN6Hep0TcYxE90p\/pCl1OZ3968Npa9P0mEZ0BTxDwFqE+U+OvW6dRYVsj6XaUxgfjiw+QcNSgwS7Fma1b1Z1ZVerCEC11j5YXa3wXPxa33DwSx\/nGx2TogBlkXqJroAnuW\/B+pji\/EN+TovcxK+ssFBg+nd\/1ImItXgj1ssKl1+nYxU4\/2psb\/e\/f2QWT3QFPExMC1ail9JtJ4\/3LrGnHVaqUy71fouveGi973VVl95Ku4tVH\/xdnJ6UdP+kXY7Jgt2nqq0Q\/gLEugmwWn5Wnt40bzvbrnCrvXoAf4wuTDybT9PJcRXb9ft9337w06PG2uOAxvTTJ6Xxgry9JIrqknm48r9ZgUprWv1DZUrtAMK1dnLPfxGQfpN19ZwbdmONKkBil8ykxo9YbK\/74i8Kr+oy5YIMP1aNpXrt2+O7JjACvpZ+D3ydBd\/3AfAMr0dMwDQNsJePFV2mlgWAZxJg8Y00XAHQlQCLL\/XeF0o7FgCxlp5oFLrSjgVAJ1qwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAggmwAACCCbAAAIIJsAAAgv0zuwAAsLGfn5\/ZRXiy39\/f2UWopAULACCYAAsAIJgACwAgmD5YABBj2Q5Dx45iGxV1U1qwAACCacECgF2dtvfUtU4FJoUWLACAeFqwAGBLV92VPj5PtELddnj620A7VgUtWAAAwbRgAcBmiobanW5ckYJ2rCJasAAAgmnBAoC9fbQtVU8lFZUOWrAAAOLNbMHKH+YAALz8PTFfj9HXP\/4+\/\/hrUZp7Tfu+sqwA6+oktRzxL294fK\/+6WHs16Pw43sYktRLoi5Hx41Lr7TEVZS4U6TTvM3imPJtUjm\/JSq2cdcDWFbTK8LqIOkYXnhOjBEV1\/78qzH9\/I2vsmsxLMQ\/ZlTxScgBBx7v5031vn2K9nXKAqzff71\/0ngmRFfDnpGBX5tjW8v7GUy3KmVeP7\/\/lbPx+\/anO5bm\/rFX4n9v3TZVZm7zUYbMAw7ALDUtWFcPMJYV+Az+iAZeV8L7v9PZFV0\/4cFExdX7XsfGTNNdHBLbvP7UXhjgMQbcBzzxq9V3cv\/9\/f17APz8\/KQbBhJ\/Pe3FctsZ5b1\/UmAKRX19iqp8JXEME1oGB7xyTKScX\/j8fBMlyal7uti9c6+WU+b8ernHAWwkfhThaW+SzLaN291vN25M4TTCiC1zIpGcXa4662S+WspJuSXm6Be4hMdYs+RU5DGVhW\/zvG\/u82o0TH0n99umo9PPPxobP3rM3O7eXoDbFK62uWopLcrxqCgKKe2s875xSLjTYwRiS6+m8bkHamzfWqEKAFzpMg\/WRzeR6qk4bne\/6o9Sl8Jtz6HTvEpzfPfRzJPf6nOc6aS9xeh1BHZ8YH\/J\/AVfUk2ABygLsNL393RUcRsBNO7ensIxxrptJGgvc\/77oAEtFr2f1nPjA9EJ0NsKd5WWZv7dy7+UphasurDjVvvBHX962qerqG6I2re\/TuA3uSKpFe4jpY4v0\/dtdAR4trIAq+6VH\/yZe\/3c5t4yPHMw30TgVOnA5JyRXtSpacG6bW5p7wzUsvuUiyOkzHWNWCOfsiGDBBsnpxg5PURX7QM\/16kLAB9mLvbM82w9tG1MmQMnx9KCBeSM4kovm3HcoHrEOu8qp2lIT6xQd99v3D0khStFl2a1dGpFc4nVladox5B+lFMiiX7XyVVGjduMSQSAQL1asF7vLOqaNBp3D0nho\/\/4R4KnE2K155jpL690dFv9qjG948cxOe1lH1XxXcb93Zbz6kDlb\/NxUWm7AnJ+\/OdL33zWvPcurn6i0ZzZQatnwKpuhmlPoTTB2Bxv+9y859WSUYv0TPdFU3kl5oAtiq5+DlpyvypJ+yV9+nnONqflSWwGwFz1AVZOjJX+MJ1m3e4hKdzuezWvaUiO+THW65PTp3XFdA\/5O15NDV93pnLiofAwYuKLwopPro626Ar40PL0cVcJtHGXZACYbmKX8HSH3fSW6XcC+RuH272R\/lV+owgBYG+xUciwBv5na3pFCADAkRYsANhS79dn272eW4oACwDYQHpW1URnuCmTYAuwACDGRp2WNirqpgRYAMAGjr3vr1qk3mfMnhVK6uQOABBMgAUAPEfOZM4DeEUIADzQ3H5mWrAAAIJpwQKAeiaL4pQWLADgUd6nxZoVAQuwAACCCbAAAILpgwUAPNDc7nGT31ACADzGq++XV4QAAMEEWAAAwQRYAADBBFgAAMEEWADcm7usG2zHNA0s5Gri3b\/PTz98OY6EPd0rkWki63RGpxtflec2kZyST5+h+Oj23F1VKv35+5\/yz8X4c1p0mZ1unNjg4xBlXvnHvyZ2LDomQA4tWCzk9BFyfAD\/\/Ou4S8Uv7PRT\/JX1u6t0Ek\/B0wLfFimxwY4Pv78yZ56jYx2LzsV7jp3O6Ue90nVJp\/P\/Z+8OlhNVAgCKvsX7\/2+ehVWUJdA2cGNIcs5qZkRAIXLTdDLnTo\/xmbZ+dPDE8Xvy8pV17gsN\/iCBxb3MjF0tSz7+\/fl6cOKj\/3k9F3b8v2UN4zIYj7vM1NXFnfw6hxLqYWZs8tyefOkxfVh324n1vD091m\/R21e39+iVt+WxG3c+\/eBu3CLkdh63k\/Y+yveS6\/m\/9jy0rbfLzN\/ae9mZ52GYt7d1lme9fSH3H74aj7HNjMDN3Psb58XbPTy0\/OYxPWdzPTOnx6G9XW\/r9E3MpZuX83N+B+AvM4LFHa0\/379xNy6OkD2v7XRYLFu\/+eVtvHuT6bNXn8mxqNbzHPonhu42d+xKMl7c9Pg9OTRWBzwILO7oWz7EN8fGlr8m1\/UrF+P719XD\/AvcnF03M3gzfyy+9Jgud3WTe5rPf1hPnNrb+pX7fZvfxozHXH\/EGQg3IbC4r2RgYMZ6avBgf77FMgPm5Yp+5+GEwZTwzYcOvcYTU8s3tcf0Y4dj8tWde+Lm\/ffBo8Amc7C4nfHAxt5UmCuDEMuaj+7Y9SUnDSZHV5sILdPIBgdlMIgyWGbmoQ8c0ytz86+fRadf3eQT73xqwQ8isLiXlw\/3wYzvZcnJ31S0ucDkdXrw0HLrZMm+9RbXd5GOXvN+nHM\/czAwv7YPHNNDxusZnx57OzmYrbW3rbe1CrQEFjeydzPo5b7G8yhCEiibl73NJfdm86yvlOuHBiv\/ZXX1sNclVXvNDMPMLH\/0mI5\/jnVzGtng3Ng7PY5m4nqId3Nbk2\/Lrzwh4cN+53fPAACft3wbY5I7AEBMYAEAxAQWAAAAAPdmBAsAICawAABi\/\/sFDQAALSNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAAAxgQUAEBNYAACxfwEAAP\/\/uFC0mAplbmRzdHJlYW0KZW5kb2JqCjIgMCBvYmoKPDwKL1Byb2NTZXQgWy9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUldCi9Gb250IDw8Ci9GMCA1IDAgUgo+PgovWE9iamVjdCA8PAovSTEgNiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwKL1Byb2R1Y2VyIChGUERGIDEuNykKL0NyZWF0aW9uRGF0ZSAoRDoyMDI1MDYxNzA4MjIwNikKPj4KZW5kb2JqCjggMCBvYmoKPDwKL1R5cGUgL0NhdGFsb2cKL1BhZ2VzIDEgMCBSCj4+CmVuZG9iagp4cmVmCjAgOQowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAyNDggMDAwMDAgbiAKMDAwMDAyMzc3OSAwMDAwMCBuIAowMDAwMDAwMDA5IDAwMDAwIG4gCjAwMDAwMDAwODcgMDAwMDAgbiAKMDAwMDAwMDMzNSAwMDAwMCBuIAowMDAwMDAwNDMxIDAwMDAwIG4gCjAwMDAwMjM4OTMgMDAwMDAgbiAKMDAwMDAyMzk2OCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDkKL1Jvb3QgOCAwIFIKL0luZm8gNyAwIFIKPj4Kc3RhcnR4cmVmCjI0MDE3CiUlRU9GCg=="
               }
            ]
         }
      ],
      "residential":false,
      "addresses":[
         {
            "address_1":"251 Little Falls Drive",
            "address_2":null,
            "address_3":null,
            "zip":"19808",
            "city":"Wilmington",
            "country":"US",
            "state":"DE",
            "region":null,
            "contact":{
               "name":"Danail Deltchev",
               "contact_name":"Threecolts LLC",
               "email":"ddeltchev@threecolts.com",
               "phone":"2126654322"
            }
         },
         {
            "address_1":"233 S Wacker Dr",
            "address_2":null,
            "address_3":null,
            "zip":"60606",
            "city":"Chicago",
            "country":"US",
            "state":"IL",
            "region":null,
            "contact":{
               "name":"Charlie Smith",
               "contact_name":"Charlie Smith",
               "email":null,
               "phone":"2126654322"
            }
         }
      ],
      "published_rate":"50.03",
      "rate_detail":[
         {
            "type":"Transportation",
            "amount":"33.19",
            "published_rate":"33.19"
         },
         {
            "type":"Delivery Area Surcharge",
            "amount":"4.20",
            "published_rate":"4.20"
         },
         {
            "type":"Fuel Surcharge",
            "amount":"3.94",
            "published_rate":"3.94"
         },
         {
            "type":"Signature (Adult Signature)",
            "amount":"8.70",
            "published_rate":"8.70"
         }
      ]
   }
}

For the creation (or update) of the Label Request we can take all information from here:

• tracking - Orders > Shipping Track Number AND Label Request > Tracking Number (new field!)
• carrier - Orders > Shipping Carrier AND Label Request > Courier
  • Match the selected carrier when storing the label request by comparing the carrier value from the Rates with values stored in Courier > Courier Shipping Provider > Courier ID. If there is a match we can select said courier and use its ID for “Label Request > Courier” and its Name for “Orders > Shipping Carrier”. If there is no match we should store the value as received form the payload on the order and no value in the Label Request
• rate - Label Request > Rate
• Collection Date - always store the Day of the request
• Label Count - to start always store 1
• packages > options > Reference > value - Label Request > Courier request id

The only thing we don’t have is the desc from the previous calls to know a human readable view of the label service

If this is a success we should also store the status as “Ready”

On error from the Label request we are to store as much information as possible for the Label Request based on the info and mapping provided in the Get Rates document and this one here and store a label request on an error status.

Example Error Response:

{
    "status": 500,
    "message": "There is a problem with your request. Please contact your sales representative or testing+support@splgroup.com for assistance."
}

OR

{"status":422,"message":"The given data was invalid.","errors":{"carrier_service":["The selected carrier service is invalid."]}}

We are to take the information from the message field in the response. If errors exists we should take this information as well as this is the place from where we take all the details about the issue

Please note - putting the label on Pending will do nothing, we are NOT to look for pending records in this table to trigger label requests. If we want to automate label requests to automatically pull down labels in MCP we should build this by having a script checking orders with correct parameters and then running them through the steps as if a user manually clicked bulk label request.