Transportnett Booking API reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

Create a Transportnett Booking

This method will create a new booking in the Transportnett system. As part of the response you will get information about the order created and its consignment number.

Request

Header

 
Accept: text/xml
X-TN-API-Uid: YOURUSERID
X-TN-API-Key: YOURPASSWORD

HTTP Request

    POST https://orders.lognett.no/api/TnOrder/CreateOrder

Parameters

The method does not require any parametes

Request Body

  <TransportBooking>
  <TransactionHeader>
    <MemberID>016532</MemberID>
    <!--The buyer ID supplied from Transportnett-->
    <RegDate>20130731</RegDate>
    
    <NumberOfOrders>001</NumberOfOrders>
  </TransactionHeader>
  <TransportOrder>
    <OrderHeader>
      <FileOrderID>1</FileOrderID>
      <!--The unique order number in this transaction (typically serial number) -->
      <OrderFunctionCode>9</OrderFunctionCode>
      <!--The order function (9 = new / original, 4 = change / update).-->
      <LocID>58</LocID>
      <OrderTypeID>4</OrderTypeID>
      <!--tn: direct order type 1 = Transport Order, 3 = Pre booking -->
      <Route>58LB</Route>
      <Suppliers>
        <TSPID>221</TSPID>
      </Suppliers>
      <TSPProductID>81</TSPProductID>
      <TSUID>016532</TSUID>
      <TSUOrderPlacer>Tor-W.B.Paasche</TSUOrderPlacer>
      <AutoCreateConsignmentNumber>1</AutoCreateConsignmentNumber>
      <Consignor>
        <Name>ELEKTROSKANDIA NORGE AS</Name>
        <Address1>POSTBOKS 205 ALNABRU</Address1>
        <Address2></Address2>
        <ZipCode>0614</ZipCode>
        <Place>OSLO</Place>
        <Country>NO</Country>
      </Consignor>
      <Consignee>
        <Name>6880 CAVERION NORGE AS</Name>
        <Address1>POSTVEIEN 2</Address1>
        <Address2></Address2>
        <ZipCode>8200</ZipCode>
        <Place>FAUSKE</Place>
        <Country>NO</Country>
      </Consignee>
      <From>
        <Name>ELEKTROSKANDIA NORGE AS</Name>
        <Address1>ENGROSSENTERET</Address1>
        <Address2></Address2>
        <ZipCode>8001</ZipCode>
        <Place>BODØ</Place>
        <Country>NO</Country>
      </From>
      <To>
        <Name>CAVERION NORGE AS</Name>
        <Address1>-</Address1>
        <Address2>POSTVEIEN 2</Address2>
        <ZipCode>8200</ZipCode>
        <Place>FAUSKE</Place>
        <Country>NO</Country>
        <Phone>91533404</Phone>
        <Email>tor.paasche@caverion.no</Email>
      </To>
      <Invoice>
        <Name>ELEKTROSKANDIA NORGE AS</Name>
        <Address1>POSTBOKS 205 ALNABRU</Address1>
        <Address2></Address2>
        <ZipCode>0614</ZipCode>
        <Place>OSLO</Place>
        <Country>NO</Country>
      </Invoice>
      <SendersCustomerNumber>1000835</SendersCustomerNumber>
      <ReceiversCustomerNumber>48736</ReceiversCustomerNumber>
      <ConsignorRef>748802</ConsignorRef>
      <ConsigneeRef>S-6882.00396</ConsigneeRef>
      <ETD>201308011400</ETD>
      <ETA>201308021600</ETA>
      <Payer>1</Payer>
      <DeliveryInstruction></DeliveryInstruction>
      <AdditionalInformation></AdditionalInformation>
      <TotalWeight>000000000,82</TotalWeight>
      <TotalCubic>000000000,001</TotalCubic>
      <NumberOrderDetail>1</NumberOrderDetail>
      <FromTerminal>8012</FromTerminal>
      <IssuerEmail>Kontakt Elektroskandia på tlf: 81559839</IssuerEmail>
    </OrderHeader>
    <OrderDetail>
      <NumberOfPackages>1</NumberOfPackages>
      <Weight>000000000,82</Weight>
      <Cubic>000000000,001</Cubic>
    </OrderDetail>
  </TransportOrder>
</TransportBooking>

Response

If successful, this method returns a response body with the following structure:

<TransportnettBookingResponse>
<ConsignmentNumber>70706400039335294</ConsignmentNumber>
<KolliIds>
<KolliId>370706400334378348</KolliId>
</KolliIds>
<Message>Saved transportnett booking.</Message>
<StatusId>0</StatusId>
<TNOrderId>15198382</TNOrderId>
 </TransportnettBookingResponse>
                

Update event for a existing order.

Request

Header

 
Accept: text/xml
X-TN-API-Uid: YOURUSERID
X-TN-API-Key: YOURPASSWORD

HTTP Request

    POST https://orders.lognett.no/api/TnOrder/OrderEvent

Parameters

The method does not require any parametes

Request Body

                    <TNOrderEventUpdate>
  <Consignments>
    <Consignment>
      <TNOrderId>14985321</TNOrderId>
      <ConsignmentId>70706400039335270</ConsignmentId>
      <Packages>
        <Package>
          <PackageId>70706400038648920</PackageId>
          <Event>
            <Description>50004</Description>
            <Status>50004</Status>
            <City>Oslo</City>
            <OccuredAtIsoDateTime>2013-04-12T12:24:17.2506321+02:00</OccuredAtIsoDateTime>
          </Event>
        </Package>
      </Packages>
    </Consignment>
  </Consignments>
</TNOrderEventUpdate>

Response

If successful, this method returns a response body with the following structure:

<TNEventUpdateResponse>
  <Status>Success</Status>
</TNEventUpdateResponse>