Overview

Carrier Settings lets Pacejet administrators define carrier-specific defaults and special behaviors beyond the basic options configured during initial carrier setup. Use Carrier Settings when you need to store or control details such as credentials, pickup and delivery windows, document types, reference field mappings, and other settings that affect how a carrier is used in shipping workflows.

Learn more about it in the article: How to Use Carrier Settings.

BlueGrace Carrier Settings Reference

The following settings come preconfigured with the BlueGrace integration. Add a setting in Carrier Settings only when the shipper needs a different value than the default.

Tip: Use these values only when they match the shipper's BlueGrace configuration and business process. Time-based settings are especially important when scheduling pickups and deliveries.

Carrier setting	What it controls	Default / supported values	Example
`DefaultCarrierEarliestPickupTime`	Sets the earliest pickup (ready) time sent to BlueGrace when the shipment doesn't include one.	Format: `HH:mm`	`<DefaultCarrierEarliestPickupTime>08:00</DefaultCarrierEarliestPickupTime>`
`DefaultCarrierLastPickupTime`	Sets the latest pickup (close) time sent to BlueGrace.	Format: `HH:mm`	`<DefaultCarrierLastPickupTime>17:00</DefaultCarrierLastPickupTime>`
`DefaultDestinationStartTime`	Sets the start of the delivery window at the destination.	Format: `HH:mm`	`<DefaultDestinationStartTime>08:00</DefaultDestinationStartTime>`
`DefaultDestinationEndTime`	Sets the end of the delivery window at the destination.	Format: `HH:mm`	`<DefaultDestinationEndTime>17:00</DefaultDestinationEndTime>`
`DefaultContainerUOM`	Sets the handling unit type sent to BlueGrace when a package type isn't mapped.	Values: `Bag`, `Boxes`, `Bundles`, `Cartons`, `Cases`, `Crates`, `Drums`, `Loose`, `Pails`, `Pallets`, `Pieces`, `Poles`, `Totes`, `Rolls`	`<DefaultContainerUOM>Pallets</DefaultContainerUOM>`
`DoNotUseCarrierProBill`	Controls whether the PRO number returned by BlueGrace becomes the shipment's carrier PRO. When set to `True`, Pacejet keeps its own PRO number instead.	Values: `True`, `False`	`<DoNotUseCarrierProBill>True</DoNotUseCarrierProBill>`

Settings You Add Manually

These settings have no default. Credentials are required before BlueGrace can rate or ship.

Important: These settings are read by the BlueGrace integration but are not created automatically during carrier setup. Add each setting manually in Carrier Settings only if you need the behavior it controls.

Carrier setting	What it controls	Default / supported values	Example
`BlueGraceUserID`	The username Pacejet uses to sign in to the BlueGrace API. Required.	Provided by BlueGrace	`<BlueGraceUserID>myuser</BlueGraceUserID>`
`BlueGracePassword`	The password Pacejet uses to sign in to the BlueGrace API. Required. Treat as a sensitive value.	Provided by BlueGrace	`<BlueGracePassword>mypassword</BlueGracePassword>`
`BlueGraceTestMode`	Sends requests to the BlueGrace test environment instead of production.	Values: `True`, `False`. Blank uses production.	`<BlueGraceTestMode>True</BlueGraceTestMode>`
`BlueGraceAutoCreateClassOfService`	Automatically adds a class of service when BlueGrace returns a service that isn't already set up in Pacejet.	Values: `True`, `False`	`<BlueGraceAutoCreateClassOfService>True</BlueGraceAutoCreateClassOfService>`
`BlueGraceDeferredPrint`	Delays printing of documents and labels to a later step instead of printing at ship time.	Values: `True`, `False`. Blank prints at ship time.	`<BlueGraceDeferredPrint>True</BlueGraceDeferredPrint>`
`SendNmfcCode`	Controls whether NMFC codes are sent on the shipment. Set to `False` to leave them off.	Values: `True`, `False`. Blank sends NMFC codes.	`<SendNmfcCode>False</SendNmfcCode>`
`PauseForDocuments`	Number of seconds Pacejet waits before requesting shipping documents, giving BlueGrace time to generate them.	Default: `5`	`<PauseForDocuments>10</PauseForDocuments>`
`SpecialInstructionsMessageType`	Lists the reference fields whose values are combined into the shipment's special instructions. Separate multiple fields with commas.	Blank sends no special instructions	`<SpecialInstructionsMessageType>DELIVERY_NOTES,SHIPPING_INSTRUCTIONS</SpecialInstructionsMessageType>`
`HazMatEmergencyResponseContactName`	The emergency response contact name sent on hazmat items.	Free text	`<HazMatEmergencyResponseContactName>CHEMTREC</HazMatEmergencyResponseContactName>`
`HazMatEmergencyResponseContactNumber`	The emergency response phone number sent on hazmat items.	Phone number	`<HazMatEmergencyResponseContactNumber>800-424-9300</HazMatEmergencyResponseContactNumber>`

Tip: Use SpecialInstructionsMessageType for special instructions. Numbered versions such as SpecialInstructions1MessageType are not used by the BlueGrace integration.

Documents

The Documents setting controls which BlueGrace documents Pacejet retrieves after a shipment is created and which printer each one goes to. The key is the Pacejet printer key, and the value is the BlueGrace document type.

Supported document types: Bol, VICS_BOL, TenderedBOL, PalletLabel, PalletLabel4X6, PackageLabel, DeliveryReceipt, WeightInspection, CustomerFile.

<Documents>
  <Document key="BillOfLading">Bol</Document>
  <Document key="ShipingLabel">PalletLabel</Document>
</Documents>

Reference Fields

The ReferenceData setting maps Pacejet values to BlueGrace reference fields. Each fieldid must match a reference field set up in the shipper's BlueGrace account, so coordinate new mappings with BlueGrace.

Pacejet reference field: Set ispath="false" and name the Pacejet reference field in fieldname.
Shipment data path: Set ispath="true" and enter the path to the shipment value as the element text.

<ReferenceData>
  <Reference fieldid="PO Number" fieldname="P_O_NUMBER" ispath="false"></Reference>
  <Reference fieldid="Delivery Order Number" fieldname="" ispath="true">ShipRequestEntity/TransactionDetails/CustomerTransactionId</Reference>
</ReferenceData>

When These Settings Are Most Useful

Initial setup: Add BlueGraceUserID and BlueGracePassword, and use BlueGraceTestMode while testing.
Pickup and delivery windows: Adjust the pickup and destination time settings when a site's dock hours differ from the defaults.
Documents not printing: Increase PauseForDocuments if documents are missing right after ship or use BlueGraceDeferredPrint to print them later.
New services: Use BlueGraceAutoCreateClassOfService so services returned by BlueGrace are added without manual setup.
PRO number control: Use DoNotUseCarrierProBill when the shipper supplies their own PRO number.
Hazmat: Add the emergency response contact settings before shipping hazmat with BlueGrace.

Draft: This article reflects the BlueGrace settings confirmed so far. Add additional BlueGrace-specific carrier settings here as they are verified.