Skip to main content
developer

Book Pakke i postkassenMailbox Parcel booking example

Request

Pakke i Postkassen (3584) med Pose på døren (1081) og fri retur av pakkenMailbox Parcel with Bag on door and free return of parcel

{
  "schemaVersion": 1,
  "consignments": [
    {
      "shippingDateTime": "2021-06-09T10:49:47.389+02:00",
      "parties": {
        "sender": {
          "name": "Ola Nordmann",
          "addressLine": "Testsvingen 12",
          "addressLine2": null,
          "postalCode": "0263",
          "city": "OSLO",
          "countryCode": "NO",
          "reference": "123456",
          "additionalAddressInfo": null,
          "contact": {
            "name": "Trond Nordmann",
            "email": "trond@nordmanntest.no",
            "phoneNumber": "99999999"
          }
        },
        "recipient": {
          "name": "Tore Mottaker",
          "addressLine": "Mottakerveien 14",
          "addressLine2": null,
          "postalCode": "9011",
          "city": "TROMSØ",
          "countryCode": "NO",
          "additionalAddressInfo": null,
          "contact": {
            "name": "Tore mottaker",
            "email": "tore@mottakertest.no",
            "phoneNumber": "+4791234567"
          }
        },
      },
      "product": {
        "id": "3584",
        "customerNumber": "*************",
        "additionalServices": [
          {
            "id": "1081"
          }
        ]
      },
      "returnProduct": 
      {
        "id": "9650",
        "additionalServices": null
      },
      "packages": [
        {
          "weightInKg": 0.1,
          "goodsDescription": "Testing equipment",
          "dimensions": {
            "heightInCm": 1,
            "widthInCm": 9,
            "lengthInCm": 14
          },
          "correlationId": "PACKAGE-123"
        }
      ]
    }
  ],
  "testIndicator": false
}

Submit the request

Post your request to

https://api.bring.com/booking/api/booking

Response

The Booking API generates and sends all necessary EDI messages to carry out the shipment. A URL to a PDF label is returned in the response. The label must be printed and attached to the shipment. A URL for the tracking information is also returned.

A GET request to the label URL will result in a HTTP 302 redirect to the concrete storage facility (e.g. redirect to Amazon S3). Ensure that your client follows these redirects.

{
  "consignments": [
    {
      "confirmation": {
        "consignmentNumber": "70438103433585242",
        "returnConsignmentNumber": "70438103433585259",
        "links": {
          "labels": "https://www.mybring.com/booking/labels/1234567?auth-token=5cf1dcee-4f01-4c9a-9870-12345678950b",
          "tracking": "http://sporing.bring.no/sporing.html?q=70438103433585242"
        },
        "returnLinks": 
        {
          "labels": "https://www.qa.mybring.com/booking/labels/7654321/return?auth-token=bb7752fc-5815-4e5e-a7a7-123456789477",
          "tracking": "http://sporing.bring.no/sporing.html?q=70438103433585259"
        },
        "dateAndTimes": {
          "earliestPickup": "2021-06-09T10:49:00+02:00",
          "expectedDelivery": "2021-06-11T23:59:00+02:00"
        },
        "packages": [
          {
            "packageNumber": "LA591729055NO",
            "correlationId": "PACKAGE-123"
          }
        ]
      },
      "correlationId": "INTERNAL-123456"
    }
  ]
}

Pakke i Postkassen med RFID / Mailbox Parcel with RFID (3584)

This requires an RFID printer (Zebra R410 or Zebra 500R). Zebra Programming Language (ZPL) labels are printed. The labels contains instructions for programming the passive RFID antenna in the printer’s labels with package numbers. The ZPL code also contains instructions for rendering the rest of the label (addresses, icons, barcode, etc.).