{"id":20316,"date":"2026-07-10T11:11:28","date_gmt":"2026-07-10T11:11:28","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=20316"},"modified":"2026-08-20T11:37:45","modified_gmt":"2026-08-20T11:37:45","slug":"how-to-configure-shipping-processor-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-shipping-processor-in-idempiere\/","title":{"rendered":"How to Configure Shipping Processor in iDempiere"},"content":{"rendered":"\n

Introduction<\/strong><\/h2>\n\n\n\n

The Shipping Processor window in iDempiere stores the connection details a tenant uses to communicate with an external shipping carrier or courier service. Each record links a Shipping Processor Configuration to authentication credentials for a specific Organization.<\/p>\n\n\n\n

It is used within shipment and delivery operations, where warehouse or logistics staff need the system to generate shipping labels, retrieve rates, or track packages through a carrier’s API.<\/p>\n\n\n\n

Because the credentials stored here authorize outbound requests to the carrier, this window directly affects whether shipment documents can be processed, tracked, and closed successfully.<\/p>\n\n\n\n

Process Flow Diagram<\/strong><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Active Shipping Processor records are available for shipment transactions.<\/li>\n\n\n\n
  • Shipping Processor Configuration determines which carrier the connection communicates with.<\/li>\n\n\n\n
  • Name must uniquely identify each Shipping Processor within an Organization.<\/li>\n\n\n\n
  • User ID and Connection Password authenticate every request sent to the carrier service.<\/li>\n\n\n\n
  • Connection Key is optional and only required by carriers that use a secondary key.<\/li>\n\n\n\n
  • Inactive Shipping Processor records are excluded from shipment processing.<\/li>\n\n\n\n
  • Each Organization can maintain multiple Shipping Processor records for different carriers.<\/li>\n\n\n\n
  • Tenant is inherited automatically and cannot be changed on the record.<\/li>\n<\/ul>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • Organization configured in iDempiere.<\/li>\n\n\n\n
    • Shipping Processor Configuration record created for the target carrier.<\/li>\n\n\n\n
    • Valid User ID issued by the shipping carrier account.<\/li>\n\n\n\n
    • Connection Password (and Connection Key, if applicable) obtained from the carrier.<\/li>\n<\/ul>\n\n\n\n

      Navigation<\/strong><\/h2>\n\n\n\n
      Material Management and Pricing \u2192 Material Management Rules \u2192 Shipping Processor<\/strong><\/code><\/pre>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessor-1\"<\/figure>\n\n\n\n

      Opening the window displays a new record form with Tenant and Organization at the top, followed by Shipping Processor Configuration, Name, Active, and the credential fields (User ID, Connection Key, Connection Password).<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessor-2\"<\/figure>\n\n\n\n
      Configuration Steps<\/strong><\/h2>\n\n\n\n
      Step 1: Select the Organization<\/strong><\/h3>\n\n\n\n
      The Organization determines which business unit the shipping processor record belongs to and which shipment documents can use it.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Open the Organization field and select the operating unit that will use this shipping connection, for example CDC.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessor-3\"<\/figure>\n\n\n\n
      Step 2: Select Shipping Processor Configuration<\/strong><\/h3>\n\n\n\n
      This links the record to a predefined carrier configuration, which controls the carrier-specific processing logic.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Click the Shipping Processor Configuration field and choose the configuration matching the carrier this record connects to.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessor-4\"<\/figure>\n\n\n\n
      Step 3: Enter the Name<\/strong><\/h3>\n\n\n\n
      The Name identifies this connection so it can be selected later during shipment processing.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Enter a short, descriptive name, such as the carrier name and account, for example “FedEx – Main Warehouse”.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessor-5\"<\/figure>\n\n\n\n
      Step 4: Enter User ID and Connection Password<\/strong><\/h3>\n\n\n\n
      These credentials authenticate every API call made to the shipping carrier and are mandatory for the connection to function.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Enter the User ID and Connection Password exactly as issued by the carrier account. Re-verify both values before saving.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessor-6\"<\/figure>\n\n\n\n
      Step 5: Enter Connection Key (if required)<\/strong><\/h3>\n\n\n\n
      Some carriers require a secondary key in addition to the password for secure authentication.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      If the carrier issues a Connection Key, enter it here. Leave blank if not required by the selected carrier.<\/p>\n\n\n\n
      Step 6: Confirm Active Status and Save<\/strong><\/h3>\n\n\n\n
      Only Active records are available for shipment processing, so this status must be verified before saving.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Keep Active checked for records ready for use, then click Save to store the Shipping Processor record.<\/p>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Field Reference Table<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>POTS<\/td>Tenant that owns the record; system-assigned and read-only.<\/td><\/tr>
      Organization<\/td>CDC<\/td>Business unit permitted to use this shipping connection.<\/td><\/tr>
      Shipping Processor Configuration<\/td>FedEx Standard<\/td>Predefined carrier configuration linked to this record.<\/td><\/tr>
      Name<\/td>FedEx – Main Warehouse<\/td>Descriptive label used to identify the connection.<\/td><\/tr>
      Active<\/td>Checked<\/td>Controls whether the record is available for shipment processing.<\/td><\/tr>
      User ID<\/td>fedex_api_user01<\/td>Account identifier used to authenticate with the carrier.<\/td><\/tr>
      Connection Key<\/td>AK-2938X<\/td>Optional secondary key required by some carriers.<\/td><\/tr>
      Connection Password<\/td>\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022<\/td>Password used with the User ID to authenticate API requests.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
      Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
      Record cannot be saved<\/td>Connection Password left blank<\/td>Enter the required Connection Password before saving.<\/td><\/tr>
      Shipment fails to generate a label<\/td>Shipping Processor record is Inactive<\/td>Reactivate the record by checking Active.<\/td><\/tr>
      Carrier rejects the connection<\/td>Incorrect User ID or Connection Password entered<\/td>Verify credentials against the carrier account and re-enter.<\/td><\/tr>
      Wrong carrier logic applied to shipment<\/td>Incorrect Shipping Processor Configuration selected<\/td>Select the configuration that matches the intended carrier.<\/td><\/tr>
      Connection Key error from carrier<\/td>Connection Key missing for a carrier that requires it<\/td>Obtain and enter the Connection Key from the carrier account.<\/td><\/tr>
      Duplicate or confusing processor names<\/td>Name not unique or descriptive within the Organization<\/td>Rename records using a clear carrier and location naming pattern.<\/td><\/tr>
      Processor not available during shipment entry<\/td>Organization on the record does not match the transaction Organization<\/td>Update Organization or create a separate record for that Organization.<\/td><\/tr>
      Shipping Processor Configuration dropdown is empty<\/td>No Shipping Processor Configuration has been created yet<\/td>Create the configuration record first, then return to this window.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Next Steps<\/strong><\/h2>\n\n\n\n
        \n
      • Configure the Shipping Processor Configuration window if not already set up.<\/li>\n\n\n\n
      • Verify the connection by processing a test shipment document.<\/li>\n\n\n\n
      • Review Delivery or Shipment windows that reference this processor.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
        Introduction The Shipping Processor window in iDempiere stores the connection details a tenant uses to communicate with an external shipping […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[37,10],"tags":[],"class_list":["post-20316","post","type-post","status-publish","format-standard","hentry","category-idempiere-inventory","category-idempiere-product"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/20316","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=20316"}],"version-history":[{"count":3,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/20316\/revisions"}],"predecessor-version":[{"id":28104,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/20316\/revisions\/28104"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=20316"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=20316"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=20316"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}