API

Logistics APIs

POST logistics/arriving-waybills

Create new arriving waybill

HTTP method POST
URI https://api.rambase.net/logistics/arriving-waybills
Supported formats Xml, Html, Json (ex. $format=json)
Successful HTTP status code 201
API resource identifier 3618, version 3

The following body must be added to the request. Mouse over fieldnames for description and other useful information about the fields. Note that fields in bold are required/mandatory.

Format:
1
<ArrivingWaybill>
2
     <Carrier>
3
          <CarrierId
CarrierId

Required/mandatory field

Carrier identifier

Minimum value: 1000

>
{Integer}</CarrierId>
4
     </Carrier>
5
     <Tracking
Tracking

This field is optional.

>
6
          <TrackingNumber
TrackingNumber

Tracking number for this arriving waybill

This field is optional.

>
{String}</TrackingNumber>
7
     </Tracking>
8
     <Sender
Sender

The sender of the arriving waybill. Can be a customer or a supplier.

This field is optional.

>
9
          <ObjectId
ObjectId

Identifier of the object

This field is optional.

>
{Integer}</ObjectId>
10
          <ObjectType
ObjectType

Type of object

This field is optional.

>
{String}</ObjectType>
11
     </Sender>
12
</ArrivingWaybill>
1
{
2
     "arrivingWaybill": {
3
          "carrier": {
4
               "carrierId
CarrierId

Required/mandatory field

Carrier identifier

Minimum value: 1000

":
"{Integer}"
5
          },
6
          "tracking
Tracking

This field is optional.

":
{
7
               "trackingNumber
TrackingNumber

Tracking number for this arriving waybill

This field is optional.

":
"{String}"
8
          },
9
          "sender
Sender

The sender of the arriving waybill. Can be a customer or a supplier.

This field is optional.

":
{
10
               "objectId
ObjectId

Identifier of the object

This field is optional.

":
"{Integer}",
11
               "objectType
ObjectType

Type of object

This field is optional.

":
"{String}"
12
          }
13
     }
14
}

The query string is placed after the resource URL, seperated with a questionmark (?). The query string is composed of a series of query parameters with values. See the page about query parameters on how to use these parameters.

$access_token String, optional After successful login you get an access token which needs to be provided in all API requests. Even though it is possible to pass this token as query parameter, we recommended passing it using the HTTP request header as described in Authorization. Note that all access tokens have an expiration time.
$db String, optional Set the database/company for the request
$useMinimumVersion Integer, optional Used to run a new version of an API resource when your API client is running a deprecated API resource. See the Breaking changes page for more information.
$showDomainDescriptions Boolean, optional Set to "true" to include domain descriptions for fields using domain values. See the Domain values page for more information. Default value is false.
$lang String, optional Specifies the language used in the response, following the 3-letter ISO-639-1 [lll]

Read more about filters and sorting on how to use filter parameters and named filters.

Read more about filters and sorting on how to use sortable parameters

Requesting this resource will yield the following response. Mouse over fieldnames (or fieldgroups) for descriptions and other useful information about the fields.

Please note that some fields may be removed from the response, based on user roles/duties/permissions.

Format:
1
<ArrivingWaybill>
2
     <ArrivingWaybillId
ArrivingWaybillId

Arriving waybill identifier

>
{Integer}</ArrivingWaybillId>
3
     <Status
Status

Status of arriving waybill

Possible domain values can be found here

>
{Integer}</Status>
4
     <Note
Note

Note or remark for this arriving waybill

>
{String}</Note>
5
     <CreatedAt
CreatedAt

Date and time of creation

>
{Datetime}</CreatedAt>
6
     <RegistrationDate
RegistrationDate

Date of the arrival og the shipment

>
{Date}</RegistrationDate>
7
     <WeightUnit
WeightUnit

Unit used for measuring weight on the consignment in this arriving waybill. Will default to weightmeasureunit from location, but can be overwritten in each arriving waybill

Possible domain values can be found here

>
{String}</WeightUnit>
8
     <LengthUnit
LengthUnit

Unit used for measuring length, width and height of the packages in the shipment. Will default to lengthunit from location, but can be overwritten in each arriving waybill

Possible domain values can be found here

>
{String}</LengthUnit>
9
     <CreatedBy
CreatedBy

The user that created this object

>
10
          <UserId
UserId

User identifier

>
{Integer}</UserId>
11
          <Name
Name

Name of the user

>
{String}</Name>
12
          <FirstName
FirstName

First name of the user

>
{String}</FirstName>
13
          <UserLink
UserLink

User reference

>
{String}</UserLink>
14
     </CreatedBy>
15
     <Carrier>
16
          <CarrierId
CarrierId

Carrier identifier

>
{Integer}</CarrierId>
17
          <Name
Name

Name of carrier

>
{String}</Name>
18
          <CarrierLink
CarrierLink

Carrier reference

>
{String}</CarrierLink>
19
     </Carrier>
20
     <Tracking>
21
          <TrackingNumber
TrackingNumber

Tracking number for this arriving waybill

>
{String}</TrackingNumber>
22
     </Tracking>
23
     <Sender
Sender

The sender of the arriving waybill. Can be a customer or a supplier.

>
24
          <ObjectId
ObjectId

Identifier of the object

>
{Integer}</ObjectId>
25
          <ObjectType
ObjectType

Type of object

>
{String}</ObjectType>
26
          <Name
Name

Name retrieved from the object

>
{String}</Name>
27
          <ObjectLink
ObjectLink

API reference to the object

>
{String}</ObjectLink>
28
     </Sender>
29
     <Location>
30
          <LocationId
LocationId

Location identifier

>
{Integer}</LocationId>
31
          <Name
Name

Name of location

>
{String}</Name>
32
          <ShortName
ShortName

Unique abbreviation/short name of the location

>
{String}</ShortName>
33
          <LocationLink
LocationLink

Location reference

>
{String}</LocationLink>
34
     </Location>
35
     <Totals>
36
          <Packages
Packages

Number of packages belonging to this arriving waybill

>
{Integer}</Packages>
37
          <Weight
Weight

The gross weight of the consignment this arriving waybill presents

>
{Decimal}</Weight>
38
          <Length
Length

The length of the consignment

>
{Decimal}</Length>
39
          <Width
Width

The width of the consignment

>
{Decimal}</Width>
40
          <Height
Height

The height of the consignment

>
{Decimal}</Height>
41
          <Volume
Volume

The volume of the consignment. Is calculated from lenght, width and height - but can be overridden by the user.

>
{Decimal}</Volume>
42
          <Area
Area

The area an incoming consignment will use. This is calculated from length and width, but can be overridden by the user.

>
{Decimal}</Area>
43
     </Totals>
44
     <Customs>
45
          <ReportDate
ReportDate

Date when this arriving waybill were printed on the goods journal

>
{Date}</ReportDate>
46
          <ShipFromCountryCode
ShipFromCountryCode

Two-character code (ISO 3166) identifying the country this consignment was shipped from.

>
{String}</ShipFromCountryCode>
47
          <ShipToCountryCode
ShipToCountryCode

Two-character code (ISO 3166) identifying the country where this consignment is received

>
{String}</ShipToCountryCode>
48
          <TransportMethod
TransportMethod

A code for which transport (vehicle, aircraft, or ship) that was used when the goods were crossing the border - i.e. plane, train, car, car on ferry and so on.

Possible domain values can be found here

>
{String}</TransportMethod>
49
          <ImportDeclarationId
ImportDeclarationId

Import declaration identifier. Customs authorites sequal number for import declaration of goods that have been a part of bonded warehouse.

>
{String}</ImportDeclarationId>
50
          <BondedWarehouse>
51
               <CarriersGoodsNumber
CarriersGoodsNumber

Carriers goods number for bonded warehouse. This allow the carrier to transport this goods domestic, -from the border to the owner of a bonded warehouse.

>
{String}</CarriersGoodsNumber>
52
               <WarehouseOwnersGoodsNumber
WarehouseOwnersGoodsNumber

Warehouse owners goods number for bonded warehouse. Consist of 'year + bonded warehouse code +location code + day number (day of the year) + number of consignment today '. Is sent to carrier to confirm that goods have been received to bonded warehouse.

>
{String}</WarehouseOwnersGoodsNumber>
53
          </BondedWarehouse>
54
     </Customs>
55
</ArrivingWaybill>
1
{
2
     "arrivingWaybill": {
3
          "arrivingWaybillId
ArrivingWaybillId

Arriving waybill identifier

":
"{Integer}",
4
          "status
Status

Status of arriving waybill

Possible domain values can be found here

":
"{Integer}",
5
          "note
Note

Note or remark for this arriving waybill

":
"{String}",
6
          "createdAt
CreatedAt

Date and time of creation

":
"{Datetime}",
7
          "registrationDate
RegistrationDate

Date of the arrival og the shipment

":
"{Date}",
8
          "weightUnit
WeightUnit

Unit used for measuring weight on the consignment in this arriving waybill. Will default to weightmeasureunit from location, but can be overwritten in each arriving waybill

Possible domain values can be found here

":
"{String}",
9
          "lengthUnit
LengthUnit

Unit used for measuring length, width and height of the packages in the shipment. Will default to lengthunit from location, but can be overwritten in each arriving waybill

Possible domain values can be found here

":
"{String}",
10
          "createdBy
CreatedBy

The user that created this object

":
{
11
               "userId
UserId

User identifier

":
"{Integer}",
12
               "name
Name

Name of the user

":
"{String}",
13
               "firstName
FirstName

First name of the user

":
"{String}",
14
               "userLink
UserLink

User reference

":
"{String}"
15
          },
16
          "carrier": {
17
               "carrierId
CarrierId

Carrier identifier

":
"{Integer}",
18
               "name
Name

Name of carrier

":
"{String}",
19
               "carrierLink
CarrierLink

Carrier reference

":
"{String}"
20
          },
21
          "tracking": {
22
               "trackingNumber
TrackingNumber

Tracking number for this arriving waybill

":
"{String}"
23
          },
24
          "sender
Sender

The sender of the arriving waybill. Can be a customer or a supplier.

":
{
25
               "objectId
ObjectId

Identifier of the object

":
"{Integer}",
26
               "objectType
ObjectType

Type of object

":
"{String}",
27
               "name
Name

Name retrieved from the object

":
"{String}",
28
               "objectLink
ObjectLink

API reference to the object

":
"{String}"
29
          },
30
          "location": {
31
               "locationId
LocationId

Location identifier

":
"{Integer}",
32
               "name
Name

Name of location

":
"{String}",
33
               "shortName
ShortName

Unique abbreviation/short name of the location

":
"{String}",
34
               "locationLink
LocationLink

Location reference

":
"{String}"
35
          },
36
          "totals": {
37
               "packages
Packages

Number of packages belonging to this arriving waybill

":
"{Integer}",
38
               "weight
Weight

The gross weight of the consignment this arriving waybill presents

":
"{Decimal}",
39
               "length
Length

The length of the consignment

":
"{Decimal}",
40
               "width
Width

The width of the consignment

":
"{Decimal}",
41
               "height
Height

The height of the consignment

":
"{Decimal}",
42
               "volume
Volume

The volume of the consignment. Is calculated from lenght, width and height - but can be overridden by the user.

":
"{Decimal}",
43
               "area
Area

The area an incoming consignment will use. This is calculated from length and width, but can be overridden by the user.

":
"{Decimal}"
44
          },
45
          "customs": {
46
               "reportDate
ReportDate

Date when this arriving waybill were printed on the goods journal

":
"{Date}",
47
               "shipFromCountryCode
ShipFromCountryCode

Two-character code (ISO 3166) identifying the country this consignment was shipped from.

":
"{String}",
48
               "shipToCountryCode
ShipToCountryCode

Two-character code (ISO 3166) identifying the country where this consignment is received

":
"{String}",
49
               "transportMethod
TransportMethod

A code for which transport (vehicle, aircraft, or ship) that was used when the goods were crossing the border - i.e. plane, train, car, car on ferry and so on.

Possible domain values can be found here

":
"{String}",
50
               "importDeclarationId
ImportDeclarationId

Import declaration identifier. Customs authorites sequal number for import declaration of goods that have been a part of bonded warehouse.

":
"{String}",
51
               "bondedWarehouse": {
52
                    "carriersGoodsNumber
CarriersGoodsNumber

Carriers goods number for bonded warehouse. This allow the carrier to transport this goods domestic, -from the border to the owner of a bonded warehouse.

":
"{String}",
53
                    "warehouseOwnersGoodsNumber
WarehouseOwnersGoodsNumber

Warehouse owners goods number for bonded warehouse. Consist of 'year + bonded warehouse code +location code + day number (day of the year) + number of consignment today '. Is sent to carrier to confirm that goods have been received to bonded warehouse.

":
"{String}"
54
               }
55
          }
56
     }
57
}

List of available operations/actions for this resource.
See the operations documentation for more information about API operations.

Possible error codes the response might return:

Error 101015 HTTP 404 Permission not found
Error 100141 HTTP 404 Country not found
Error 104869 HTTP 404 Default account not found
Error 104500 HTTP 400 Carrier need to be active (status 4)