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:

구성¶

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 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 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.

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

• 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.

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

Production environment¶

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

창고 환경 설정¶

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.

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

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.

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¶

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

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 또는 청구서에 추가합니다.

배송 주문¶

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

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

문제 해결¶

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¶

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

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

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