Third-party shipping carriers

Users can link third-party shipping carriers to Odoo databases, in order to verify carriers’ delivery to specific addresses, automatically calculate shipping costs, and generate shipping labels.

Odoo에서는 배송업체를 판매주문서 (SO), 청구서 또는 배송주문서에 지정할 수 있습니다. 배송 커넥터 설정 시 일반적인 문제 해결에 대한 팁을 확인하려면 문제 해결 색션으로 건너뜁니다.

The following is a list of available shipping connectors in Odoo:

운송업체

Region availability

FedEx

모두

DHL Express

모두

UPS

모두

US Postal Service

아메리카 합중국

Sendcloud

Some European countries (see details below)

Bpost

벨기에

Easypost

북미 지역

Shiprocket

인도

Starshipit

Australia and New Zealand

중요

Other services from DHL are not supported.

Sendcloud currently supports shipping from Austria, Belgium, France, Germany, Italy, the Netherlands, Spain, and the United Kingdom, and to any European country.

설정

To ensure proper setup of a third-party shipping carrier with Odoo, follow these steps:

  1. Install the shipping connector.

  2. Set up delivery method.

  3. Activate production environment.

  4. Configure warehouse.

  5. Specify weight of products.

Install shipping connector

To install shipping connectors, go to Inventory app ‣ Configuration ‣ Settings.

Under the Shipping Connectors section, tick the third-party shipping carrier’s checkbox to install it. Multiple third-party shipping connectors can be selected at once. Then, click Save.

참고

Delivery methods can also be integrated with operations in the Sales, eCommerce, and Website apps. To install, refer to the install apps and modules documentation.

Options of available shipping connectors in Odoo.

Delivery method

To configure the API credentials, and activate the shipping carrier, begin by going to Inventory app ‣ Configuration ‣ Shipping Methods, and select the desired delivery method.

참고

The list often includes two delivery methods from the same Provider: one for international shipping and one for domestic shipping.

Additional delivery methods can be created for specific purposes, such as packaging.

참고

웹사이트 앱에서 배송 방법을 사용할 수 있게 하려면 게시가 되어 있는지 확인합니다. 웹사이트에 배송 방법을 게시하려면 원하는 배송 방법을 클릭한 다음 게시되지 않음 스마트 버튼을 클릭합니다. 그렇게 하면 스마트 버튼이 게시됨 으로 변경됩니다.

The Shipping Method page contains details about the provider, including:

  • Shipping Method (Required field): the name of the delivery method (e.g. FedEx US, FedEx EU, etc.).

  • 웹사이트: 데이터베이스의 특정 웹사이트에 연결되어 있는 이커머스 페이지에 대한 배송 방법을 설정합니다. 드롭다운 메뉴에서 해당 웹사이트를 선택하거나, 모든 웹페이지에 적용되게 하려면 비워둡니다.

  • Provider (Required field): choose the third-party delivery service, like FedEx. Upon choosing a provider, the Integration Level, Invoicing Policy and Insurance Percentage fields become available.

  • Integration Level: choose Get Rate to simply get an estimated shipment cost on an SO or invoice.

    중요

    Select Get Rate and Create Shipment to also generate shipping labels.

  • 회사: 특정 회사에 배송 방법을 적용해야 하는 경우 드롭다운 메뉴에서 해당 회사를 선택합니다. 모든 회사에 배송 방법을 적용하려면 이 필드를 비워둡니다.

  • Delivery Product (Required field): the delivery charge name that is added to the SO or invoice.

  • 청구서 발행 정책: 배정업체에서 직배송하는 경우의 예상 비용 을 선택하여 계산합니다. 해당 내용 대신 실제 배송비 를 선택하려면 실제 배송비 청구 문서를 참조하세요.

  • Margin on Rate: specify an additional percentage amount added to the base shipping rate to cover extra costs, such as handling fees, packaging materials, exchange rates, etc.

  • Free if order amount is above: enables free shipping for orders surpassing a specified amount entered in the corresponding Amount field.

  • Insurance Percentage: specify a percentage amount of the shipping costs reimbursed to the senders if the package is lost or stolen in transit.

Screenshot of a FedEx shipping method.

Shipping Method configuration page for FedEx US.

환경 설정 탭에서 API 자격 증명 필드 (예: API 키, 비밀번호, 계정 번호 등)를 입력합니다. 제공업체 에서 선택한 타사 운송업체에 따라 환경 설정 탭의 필수 입력 항목이 달라집니다. 특정 운송업체용 자격 증명을 환경 설정하는 자세한 내용에 대해서는 다음 문서를 참조하세요.

Production environment

With the delivery method details configured, click the Test Environment smart button to set it to Production Environment.

경고

배송 방법을 프로덕션 으로 설정하면 실제 배송 라벨이 생성되며, 사용자가 고객에게 요금을 청구하기 전에 운송업체 계정 (예: UPS, FedEx 등)을 통해 배송비가 청구될 가능성이 있습니다. 배송 방법을 프로덕션 으로 시작하기 전에 환경 설정이 모두 정확한지 확인하세요.

Show the "Test Environment" smart button.

창고 환경 설정

Ensure the warehouse’s Address (including ZIP code) and Phone number are entered accurately. To do that, go to Inventory app ‣ Configuration ‣ Warehouses, and select the desired warehouse.

On the warehouse configuration page, open the warehouse contact page by clicking the Company field.

Highlight the "Company" field.

Verify that the Address and Phone number are correct, as they are required for the shipping connector to work properly.

Show company address and phone number.

Product weight

For the carrier integration to work properly, specify the weight of products by going to Inventory app ‣ Products ‣ Products, and selecting the desired product.

Then, switch to the Inventory tab, and define the Weight of the product in the Logistics section.

Display the "Weight" field in the Inventory tab of the product form.

Apply third-party shipping carrier

Shipping carriers can be applied on a SO, invoice, or delivery order.

After configuring the third-party carrier’s delivery method in Odoo, create or navigate to a quotation by going to Sales app ‣ Orders ‣ Quotations.

Sales order

타사 배송업체를 지정하고 예상 배송비를 확인하려면 판매 앱 ‣ 주문서 ‣ 견적서 로 이동합니다. 주문 내역 탭의 오른쪽 하단에 있는 배송 추가 버튼을 클릭하여 새로 생성하거나 기존 견적서를 선택한 후 타사 운송업체를 통할 경우의 배송비를 견적에 추가합니다. .

Show the "Add shipping" button at the bottom of a quotation.

In the resulting Add a shipping method pop-up window, select the intended carrier from the Shipping Method drop-down menu. The Cost field is automatically filled based on:

  • the amount specified in the Total Order Weight field (if it is not provided, the sum of product weights in the order is used)

  • the distance between the warehouse’s source address and the customer’s address.

배송 방법 필드에서 타사 공급업체를 선택한 후 배송 방법 추가 팝업 창에서 요금 받기 를 클릭하여 배송 커넥터를 통한 예상 비용을 확인합니다. 그런 다음 추가 버튼을 클릭하여 배송료를 SO 또는 청구서에 추가합니다.

배송 주문

판매 앱을 설치하지 않고 배송하려면, 먼저 재고 관리 앱으로 이동하여 배송주문서에 배송업체를 지정합니다. 그런 다음 재고 개요 현황판에서 배송주문서 작업 유형을 선택하고 아직 완료 또는 취소됨 으로 표시되지 않은 배송주문서를 선택합니다. .

추가 정보 탭에 있는 배송업체 항목을 원하는 타사 배송업체로 설정합니다. 배송 방법을 프로덕션 모드 로 설정하면 조회 참조 를 사용할 수 있습니다.

Show the delivery order's "Additional info" tab.

문제 해결

Since shipping connectors can sometimes be complex to set up, here are some checks to try when things are not working as expected:

  1. Ensure the warehouse information (e.g., address and phone number) in Odoo is correct and matches the records saved in the shipping provider’s website.

  2. Verify that the package type and parameters are valid for the shipping carrier. To check, ensure the shipment can be directly created on the shipping carrier’s website.

  3. When encountering a price mismatch between Odoo’s estimated cost and the provider’s charge, first ensure the delivery method is set to production environment.

    Then, create the shipment in both the carrier’s website and Odoo, and verify the prices are the same across Odoo, the shipping provider, and in the debug logs.

    Example

    디버그 로그에서 가격 불일치 내용을 확인할 때 요청 사항에는 패키지 무게가 6kg이라고 되어 있으나 FedEx에서 확인 시 패키지 무게가 7kg인 경우에는 FedEx 측에 문제가 있는 것으로 결론을 내립니다.

Debug log

디버그 로그를 활성화하여 배송 데이터가 불일치하는 내역을 추적합니다. 배송 방법에 대한 설정 페이지 (재고 관리 앱 ‣ 환경 설정 ‣ 배송 방법)로 이동하여 원하는 배송 방법을 선택합니다. 디버그 요청 을 활성화하려면 디버그 안함 스마트 버튼을 클릭합니다.

Show the "No Debug" smart button.

디버그 요청 이 활성화되어 있으면 배송 커넥터를 사용하여 예상 배송비를 계산할 때마다 로깅 보고서에 레코드가 저장됩니다. 보고서에 액세스하려면 개발자 모드 를 켜고 설정 앱 ‣ 기술 ‣ 데이터베이스 구조 섹션 ‣ 로깅 으로 이동합니다.

참고

배송 방법에 대한 로그가 생성되는 경우는, SO 및 청구서에서 요금 확인 버튼을 클릭할 때마다이며, 동시에 고객이 웹사이트 앱을 통해 주문에 배송업체를 추가하는 경우입니다.

Show how to find the "Logging" option from the "Technical" menu.

HTTP 요청 항목을 클릭하여 세부 페이지를 열고 Odoo에서 배송업체로 정확한 정보가 전송되었는지 확인합니다. HTTP 응답 에서 동일한 정보가 수신되는지 확인합니다.

Show debug request history in Settings > Technical > Logging.