{"id":20251,"date":"2026-07-10T11:13:36","date_gmt":"2026-07-10T11:13:36","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=20251"},"modified":"2026-08-20T09:06:27","modified_gmt":"2026-08-20T09:06:27","slug":"how-to-configure-shipping-processor-configuration-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-shipping-processor-configuration-in-idempiere\/","title":{"rendered":"How to Configure Shipping Processor Configuration in iDempiere"},"content":{"rendered":"\n

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

The Shipping Processor Configuration window in iDempiere defines how the system connects to an external carrier or freight service, using a Shipping Processor Java Class to handle rate calls, labels, and tracking.<\/p>\n\n\n\n

It is used in Material Management when shipments to customers require carrier-specific rating, packaging, and pickup options rather than manual freight entry.<\/p>\n\n\n\n

This configuration directly affects shipment processing, tracking accuracy, and carrier-related reporting across the tenant and its organizations.<\/p>\n\n\n\n

Process Flow Diagram<\/strong><\/h2>\n\n\n\n
\"TenthPlanet-iDempiere-Master-ShippingProcessorConfiguration-ProcessFlow\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Active records are available for shipment processing; inactive processors are excluded from selection.<\/li>\n\n\n\n
  • Host Address and Host port are mandatory for the processor to connect to the carrier system.<\/li>\n\n\n\n
  • A single Shipping Processor Configuration can hold multiple Shipper records.<\/li>\n\n\n\n
  • Shipper records exist only under a parent Shipping Processor Configuration.<\/li>\n\n\n\n
  • Tracking URL, when set on a Shipper, enables shipment tracking directly from iDempiere.<\/li>\n\n\n\n
  • International, Saturday Delivery, and Residential flags control which delivery services a shipper supports.<\/li>\n\n\n\n
  • Proxy fields are optional and used only when outbound calls route through a proxy server.<\/li>\n\n\n\n
  • Shipping Processor Class must reference a valid Java class implementing the shipment processor interface.<\/li>\n<\/ul>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • Tenant (Client) configured.<\/li>\n\n\n\n
    • Organization configured.<\/li>\n\n\n\n
    • Business Partner and Shipment (Customer) window available for shipment processing.<\/li>\n\n\n\n
    • Java class for Shipping Processor Class (e.g., MFreightShipmentProcessor) available in the system.<\/li>\n\n\n\n
    • User role with access to Material Management setup windows.<\/li>\n<\/ul>\n\n\n\n

      Navigation<\/strong><\/h2>\n\n\n\n
      Menu \u2192 Material Management and Pricing \u2192 Material Management Rules \u2192 Shipping Processor Configuration<\/strong><\/code><\/pre>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessorConfiguration-1\"<\/figure>\n\n\n\n
      On opening, users see the header form (Tenant, Organization, Name, Host Address, Host port, Proxy fields, Shipping Processor Class) with a Shipper tab grid below listing configured shippers.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessorConfiguration-2\"<\/figure>\n\n\n\n
      Configuration Steps<\/strong><\/h2>\n\n\n\n
      Step 1: Create the Shipping Processor Configuration<\/strong><\/h3>\n\n\n\n
      This step establishes the base connection record the system uses to reach the carrier’s service.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Enter Name and Description, set Active, provide Host Address and Host port, then enter the Shipping Processor Class. Save the record before adding shippers.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessorConfiguration-3\"<\/figure>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Name<\/td>Freight Table Shipment Processor<\/td>Identifies the processor configuration<\/td><\/tr>
      Host Address<\/td>0.0.0.0<\/td>Carrier service endpoint address<\/td><\/tr>
      Host port<\/td>0<\/td>Port used to connect to the carrier service<\/td><\/tr>
      Shipping Processor Class<\/td>org.adempiere.model.MFreightShipmentProcessor<\/td>Java class implementing the processor logic<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 2: Configure Proxy Settings (if applicable)<\/strong><\/h3>\n\n\n\n
      Required only when outbound requests to the carrier must route through a network proxy.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Enter Proxy address, Proxy port, Proxy logon, and Proxy password if the environment requires proxy routing; otherwise leave these fields blank.<\/p>\n\n\n\n
      Step 3: Add a Shipper Record<\/strong><\/h3>\n\n\n\n
      Each shipper record represents a specific carrier or service level under the processor, such as Blue Dart Express.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Open the Shipper tab, click New, enter Name and Description, set Active, and enable Online Access if the carrier supports API-based calls.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Master-ShippingProcessorConfiguration-4\"<\/figure>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Purpose<\/strong><\/td><\/tr><\/thead>
      Name<\/td>Blue Dart Express<\/td>Identifies the shipper or carrier<\/td><\/tr>
      Service Code<\/td>(carrier-specific)<\/td>Carrier’s internal service identifier<\/td><\/tr>
      Tracking URL<\/td>(carrier tracking link)<\/td>Template used to track shipments<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 4: Set Shipper Service Options<\/strong><\/h3>\n\n\n\n
      These flags determine which delivery capabilities are available when this shipper is selected on a shipment.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Check International, Saturday Delivery, or Residential based on the carrier’s actual service capability, then save the Shipper record.<\/p>\n\n\n\n

      Step 5: Configure Packaging, Label Type, and Pickup Types<\/strong><\/h3>\n\n\n\n
      These sub-tabs define package sizes, label formats, and pickup schedules used when generating shipments with this shipper.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Open Packaging, Label Type, or Pickup Types under the Shipper tab and add records matching the carrier’s supported packaging, label, and pickup options.<\/p>\n\n\n\n
      Note:<\/strong> Sub-tab records (Packaging, Label Type, Pickup Types) are only available once the parent Shipper record has been saved.<\/code><\/pre>\n\n\n\n
      Common Issues and Resolutions<\/strong><\/h3>\n\n\n\n
      Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
      Shipment fails to connect to carrier<\/td>Host Address or Host port is incorrect or unreachable<\/td>Verify Host Address and Host port against carrier documentation<\/td><\/tr>
      Proxy connection errors<\/td>Proxy address, port, logon, or password incomplete<\/td>Confirm all proxy fields with the network team<\/td><\/tr>
      Shipper not available during shipment entry<\/td>Shipper record is inactive<\/td>Set the Shipper record to Active<\/td><\/tr>
      Tracking link not shown for shipment<\/td>Tracking URL not configured on Shipper<\/td>Add a valid Tracking URL template<\/td><\/tr>
      Processor class not found error<\/td>Shipping Processor Class name is invalid or misspelled<\/td>Verify the class matches an installed Java implementation<\/td><\/tr>
      Saturday or International delivery not offered<\/td>Related flag not checked on Shipper<\/td>Enable the relevant checkbox on the Shipper tab<\/td><\/tr>
      Duplicate shipper entries<\/td>Multiple shippers created with the same name<\/td>Use unique, descriptive shipper names per carrier<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Next Steps<\/strong><\/h3>\n\n\n\n
        \n
      • Configure the Shipment (Customer) window to select the new shipper.<\/li>\n\n\n\n
      • Set up Packaging types for accurate freight and box-size calculation.<\/li>\n\n\n\n
      • Configure Label Type templates to meet carrier compliance requirements.<\/li>\n\n\n\n
      • Review Pickup Types to align shipment generation with logistics scheduling.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
        Introduction The Shipping Processor Configuration window in iDempiere defines how the system connects to an external carrier or freight service, […]<\/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-20251","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\/20251","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=20251"}],"version-history":[{"count":2,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/20251\/revisions"}],"predecessor-version":[{"id":27894,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/20251\/revisions\/27894"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=20251"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=20251"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=20251"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}