📢 کانال اطلاع‌رسانی ای‌تیپاکس در پیام‌رسان بله: آخرین اخبار، بروزرسانی‌ها و آموزش‌ها را در کانال بله ما دنبال کنید.
عضویت در کانال
مستندات خانه

سامانه اطلاع‌رسانی تجارت هوشمند تیپاکس

راهنمای جامع مستندات و سامانه‌های تجارت هوشمند تیپاکس. برای مشاهده مستندات هر نسخه، روی کارت مورد نظر کلیک کنید — تمام جزئیات و جداول آن نسخه در یک صفحه نمایش داده می‌شود.

Latest

مستندات API V4

جدیدترین نسخه API تیپاکس با ۷۶ اندپوینت در ۱۷ گروه. شامل ۶ روش ثبت سفارش، Device Register، Return Order و Pickup مرسوله.

۷۶ اندپوینت
۱۷ گروه
۱۴۵ Schema
Stable

مستندات API V3

نسخه پایدار قبلی با ۱۰۵ اندپوینت در ۲۳ گروه. شامل باکس لاین (Box Line)، لاکر، Webhook، تیکتینگ و تراکنش‌های مالی.

۱۰۵ اندپوینت
۲۳ گروه
۱۹۸ Schema
به‌زودی

سامانه قبول

سامانه ویژه شعب و نمایندگی‌های تیپاکس برای قبول، ثبت و تحویل مرسولات در سطح محلی. مستندات به‌زودی.

— اندپوینت
— گروه
— Schema

راهنماها و آموزش‌ها

ای‌تیپاکس

پلتفرم فروش سازمانی

ربات بله

ثبت سفارش از پیام‌رسان بله

پلاگین وردپرس

اتصال ووکامرس به تیپاکس

مای‌تیپاکس

اپلیکیشن موبایل

دانلود فایل اکسل نمونه ثبت سفارش گروهی

برای ثبت سفارش گروهی، فایل اکسل نمونه را دانلود کنید، اطلاعات مرسولات را تکمیل کرده و در سامانه ای‌تیپاکس آپلود نمایید.

دانلود فایل اکسل
جدیدترین نسخه API تیپاکس • بر اساس OpenAPI 3.0.1 رسمی

مستندات API نسخه ۴ (V4)

جدیدترین و پیشرفته‌ترین نسخه API تیپاکس با ۷۶ اندپوینت در ۱۷ گروه. تمام جزئیات و جداول این نسخه در همین صفحه نمایش داده شده است. برای دسترسی سریع به هر گروه، از لینک‌های زیر استفاده کنید یا صفحه را اسکرول کنید.

Base URL (پروداکشن)omapi.tipax.ir
Base URL (تست)omtestapi.tipax.ir
تعداد اندپوینت۷۶
Document UI V4 Swagger V4

۶ روش ثبت سفارش

OmOrder، DeviceRegister، ReturnRegister و...

Pickup مرسوله

جمع‌آوری با PickupParcelWithUpdateBarcode

Device Register

ثبت سفارش از دستگاه با creatorBranchId

Return Order

ثبت مرجوعی با OmV4ReturnOrderRegister

Locker (V4)

جستجوی کیوسک با lat/lon/cityId

Webhook اختصاصی

successCallbackUrl + failureCallbackUrl

احراز هویت در V4

۱
ثبت‌نام در https://etipaxco.com/register و ورود به https://etipaxco.com/login
۲
دریافت apiKey از پروفایل کسب‌وکار در پنل
۳
ارسال POST به https://igtgatewayapi.tipax.ir/Token با username، password، "grant_type": "password" //این بخش را بدون تغییر بگذارید
۴
ارسال هدر Authorization: Bearer YOUR_ACCESS_TOKEN در تمام درخواست‌ها
دسترسی سریع به ۱۷ گروه:
احراز هویت مدیریت مشتری مدیریت آدرس ثبت سفارش مرسولات بسته‌های مشتری وضعیت مرسولات محاسبه هزینه انواع پرداخت بسته‌بندی رهگیری لاکر مالی تیکتینگ شهرها استان‌ها ویرایش مشتری حقیقی

جزئیات و جداول API V4 (۱۷ گروه، ۷۶ اندپوینت)

احراز هویت 1 اندپوینت

ورود و توکن — گروه Account

اندپوینت‌های این گروه

1 اندپوینت
POST
/api/OM/v4/Account/RefreshToken
ورود
RefreshTokenDto | AccessTokenApiResult
پایدار

نمونه درخواست — احراز هویت

POST /api/OM/v4/Account/RefreshToken

RefreshTokenDto.json 
{
  "token": "string",
  "refreshToken": "string"
}

مدیریت مشتری 18 اندپوینت

مشتری، کیف پول، شعب — گروه Customers

اندپوینت‌های این گروه

18 اندپوینت
POST
/api/OM/v4/Customers/GetCustomers
OmCustomerBriefListDtoListApiResult
جدید
GET
/api/OM/v4/Customers
دریافت مشتری جاری
OmCustomerListDto
پایدار
GET
/api/OM/v4/Customers/Credit
دریافت اعتبار مشتری
پایدار
GET
/api/OM/v4/Customers/Wallet
دریافت موجودی کیف پول
پایدار
POST
/api/OM/v4/Customers/RechargeWallet
شارژ کیف پول
OmPaymentUrlCuDto | OmPaymentUrlListDto
پایدار
GET
/api/OM/v4/Customers/Remain
دریافت مانده حساب
پایدار
GET
/api/OM/v4/Customers/mycustomers/{id}
دریافت مشتری من
OmClientListDto
پایدار
GET
/api/OM/v4/Customers/mycustomers
دریافت لیست مشتریان من
OmClientsListDtoOmBaseListDto
پایدار
GET
/api/OM/v4/Customers/mySubstations
دریافت لیست شعب من
CustomerSubstationListDtoOmBaseListDto
پایدار
POST
/api/OM/v4/Customers/CreateMySubstation
افزودن به لیست شعب من
CustomerSubstationCuDto
پایدار
POST
/api/OM/v4/Customers/DisableMySubstation
غیرفعال کردن شعبه من
پایدار
POST
/api/OM/v4/Customers/EnableMySubstation
فعال کردن شعبه من
پایدار
POST
/api/OM/v4/Customers/RegisterForPanel
SSORegisterWithEmailAndNoPeopleRequest | SSORegisterResponseForPanelApiResult
پایدار
GET
/api/OM/v4/Customers/GetMyCustomers/{substationCode}
گرفتن لیست مشتری های شعبه ی من
OmMyCustomerListDtoListApiResult
پایدار
POST
/api/OM/v4/Customers/ApprovePhoneNumber
SSOUpdateRequest | SSORegisterResponseForPanelApiResult
پایدار
POST
/api/OM/v4/Customers/ValidateUserForPanel
SSOUserValidationDto | SSOTokenApiResult
پایدار
POST
/api/OM/v4/Customers/ApprovePhoneNumberCode
SSOUserValidationDto | AccessTokenApiResult
پایدار
POST
/api/OM/v4/Customers/ResendSMSForApprovePhoneNumber
UserIdDto | ApiResult
پایدار

نمونه درخواست — مدیریت مشتری

POST /api/OM/v4/Customers/RechargeWallet

OmPaymentUrlCuDto.json 
{
  "amount": 0,
  "frontCallBackUrl": "string"
}

مدیریت آدرس 5 اندپوینت

آدرس کسب‌وکار و دفترچه — گروه Addresses

اندپوینت‌های این گروه

5 اندپوینت
POST
/api/OM/v4/Addresses
افزودن آدرس برای مشتری جاری (آدرس کسب و کار)
OmAddressCuDto | PeopleAddressesListDto
پایدار
GET
/api/OM/v4/Addresses
دریافت لیست آدرس های کاربر(آدرس های کسب و کار)
پایدار
POST
/api/OM/v4/Addresses/Book
افزودن آدرس به دفترچه آدرس
PeopleAddressCuDto | PeopleAddressesListDto
پایدار
GET
/api/OM/v4/Addresses/Book
دریافت دفترچه آدرس کاربر
پایدار
GET
/api/OM/v4/Addresses/{id}
در یافت آدرس با کد آدرس
PeopleAddressesListDto
پایدار

ثبت سفارش 6 اندپوینت

۶ روش ثبت سفارش — گروه OmOrder

اندپوینت‌های این گروه

6 اندپوینت
POST
/api/OM/v4/OmOrder
OmV4OrderRegisterCuDto | OmV4OrderListDto
پایدار
POST
/api/OM/v4/OmOrder/RegisterOrderWithAddress
ثبت سفارش با آدرس مبدا و مقصد از پیش ساخته شده
OmV4OrderWithAddressCuDto | OmV4OrderListDto
پایدار
POST
/api/OM/v4/OmOrder/WithPreDefinedOrigin
ثبت سفارش با مبدأ از پیش تعریف شده
OmV4OrderWithOriginAddressCuDto | OmV4OrderListDto
پایدار
POST
/api/OM/v4/OmOrder/WithClientAndAddress
ثبت سفارش با آدرس مبدا و مقصد
OmV4OrderWithClientAndAddressCuDto | OmV4OrderListDto
V4
POST
/api/OM/v4/OmOrder/DeviceRegisterOrder
OmV4DeviceOrderRegister | OmV4OrderListDto
Device
POST
/api/OM/v4/OmOrder/ReturnRegisterOrder
OmV4ReturnOrderRegister | OmV4OrderListDto
Return

نمونه درخواست — ثبت سفارش

POST /api/OM/v4/OmOrder

OmV4OrderRegisterCuDto.json 




{
  "packages": [
    {
      "origin": {
        "cityId": 1262,
        "fullAddress": "آدرس فرستنده پلاک23",
        "latitude": 51.8302611199163,
        "longitude": 35.4438412913701,
        "beneficiary": {
          "fullName": "امیر",
          "mobile": "09121234567",
          "floor": "2",
          "unit": "4",
          "postalCode": "1234567891",
          "description": "test"
        }
      },
      "destination": {
        "cityId": 1293,
        "fullAddress": "آدرس گیرنده پلاک 444",
        "latitude": 51.78712623,
        "longitude": 35.42576206,
        "floor": "12",
        "unit": "32",
        "postalCode": "8529637410",
        "beneficiary": {
          "fullName": "امیرعلی",
          "mobile": "09331234567"
        }
      },
      "customParcelTitle": "TESTL",
      "weight": 1,
      "packageValue": 10000000,
      "length": 40,
      "width": 30,
      "height": 5,
      "packingId": 522,
      "packageContentId": 36,
      "packType": 70,
      "paymentType": 20,
      "pickupType": 20,
      "distributionType": 10,
      "serviceId": 7,
      "cod": 0,
      "cashAmount": 0
    }
  ],
  "traceCode": "MP11101492",
  "secondaryTraceCode": "MP85214798910",
  "discountCode": null,
  "successCallbackUrl": "",
  "failureCallbackUrl": ""
}

POST /api/OM/v4/OmOrder/RegisterOrderWithAddress

OmV4OrderWithAddressCuDto.json 

{
  "packages": [
    {
      "originId": 29570365,
      "destinationId":70031520,
        "receiver": {
            "phone": "02191031648",
            "fullName": "محمدرضا",
            "mobile": "09981112223"
      },
      "isUnsual": false,
      "weight": 11,
      "packageValue": 20000,
      "length": 35,
      "width": 25,
      "height": 10,
      "packingId": 49,
      "packageContentId": 17,
      "packType": 20,
      "serviceId": 2,
      "paymentType": 20,
      "pickupType": 20,
      "distributionType": 10,
      "cashAmount": 12345,
      "barcode": "1234",
      "traceCode": "12433543543543"
    }
  ]
}

POST /api/OM/v4/OmOrder/WithPreDefinedOrigin

OmV4WithPreDefinedOrigin.json 

{
  "packages": [
    {
      "originId": 29570365,
      "destination": {
        "cityId": 1022,
        "fullAddress": "آدرس گیرنده پلاک 444",
        "latitude": 37.78039158,
        "longitude": 45.90133144,
        "postalCode": "8529637410",
        "beneficiary": {
          "fullName": "امیرعلی",
          "mobile": "09331234567"
        }
      },
      "customParcelTitle": "TEST",
      "weight": 1,
      "packageValue": 10000000,
      "length": 1,
      "width": 1,
      "height": 1,
      "packageContentId": 9,
      "packType": 20,
      "serviceId": 4,
      "paymentType": 20,
      "pickupType": 10,
      "distributionType": 10,
      "cod": 0,
      "cashAmount": 0
    }
  ],
  "traceCode": "MP1111492",
  "secondaryTraceCode": "MP852147878780",
  "discountCode": null
}

POST /api/OM/v4/OmOrder/WithClientAndAddress

OmV4WithClientAndAddress.json 


{
  "packages": [
    {
      "senderClientId": 23570,
      "receiverClientId": 23570,
      "senderAddressId": 71483937,
      "receiverAddressId": 71483937,
      "weight": 2,
      "packageValue": 25000000,
      "length": 20,
      "width": 20,
      "height": 20,
      "packingId": 5,
      "packageContentId": 9,
      "packType": 20,
      "description": "تست",
      "serviceId": 4,
      "enableLabelPrivacy": true,
      "paymentType": 10,
      "pickupType": 10,
      "distributionType": 10,
      "cod": 0,
      "cashAmount": 0
    }
  ]
}

مرسولات 10 اندپوینت

Pickup، ابطال، مبلغ — گروه Parcels

اندپوینت‌های این گروه

10 اندپوینت
POST
/api/OM/v4/Parcels/GetReadyForPickupList
ParcelListDtoListApiResult
Pickup
POST
/api/OM/v4/Parcels/PickupParcelWithUpdateBarcode
AcceptParcelForPickup | ApiResult
Pickup
GET
/api/OM/v4/Parcels/GetByOrderId/{orderId}
دریافت لیست مرسوله ها بر اساس شماره سفارش
OmParcelDtoOmBaseListDto
پایدار
GET
/api/OM/v4/Parcels/PaymentType/{trackingCode}
نوع پرداخت
پایدار
PUT
/api/OM/v4/Parcels/Cancel/{trackingCode}
ابطال مرسوله
پایدار
GET
/api/OM/v4/Parcels/GetAmountByTrackingCode/{trackingCode}
دریافت مبلغ مرسوله با کد رهگیری ای تیپاکس
OmOrderCostBriefListDto
پایدار
POST
/api/OM/v4/Parcels/GetSumTotalAmountByTrackingCodes
دریافت جمع هزینه ی مرسوله ها(تومان)
پایدار
GET
/api/OM/v4/Parcels/GetAmountByContractCode/{contractCode}
دریافت مبلغ مرسوله با کد قرارداد جت
OmOrderCostBriefListDto
پایدار
GET
/api/OM/v4/Parcels/GetPriceDetailByTrackingCode/{trackingCode}
دریافت جزییات مبلغ مرسوله با کد کد رهگیری ای تیپاکس
OmOrderCostListDto
پایدار
GET
/api/OM/v4/Parcels/GetPriceDetailByContractCode/{contractCode}
دریافت جزییات مبلغ مرسوله با کد قرارداد جت
OmOrderCostListDto
پایدار

بسته‌های مشتری 2 اندپوینت

دفترچه بسته — گروه ParcelBooks

اندپوینت‌های این گروه

2 اندپوینت
GET
/api/OM/v4/ParcelBooks
دریافت لیست بسته های تعریف شده مشتری
OmCustomerPackageResponseOmBaseListDto
پایدار
POST
/api/OM/v4/ParcelBooks
افزودن بسته جدید به لیست بسته های مشتری
OmCreateCustomerPackageRequest | OmCreateCustomerPackageResponse
پایدار

وضعیت مرسولات 2 اندپوینت

وضعیت و رویداد — گروه ParcelStatus

اندپوینت‌های این گروه

2 اندپوینت
GET
/api/OM/v4/ParcelStatus
لیست وضعیت ها
OmParcelStatusListDtoListApiResult
پایدار
GET
/api/OM/v4/ParcelStatus/GetEventWithStatus
لیست رویداد ها
ParcelEventTypeListDtoListApiResult
پایدار

محاسبه هزینه 5 اندپوینت

قیمت و سرویس — گروه Pricing

اندپوینت‌های این گروه

5 اندپوینت
POST
/api/OM/v4/Pricing
دریافت قیمت
OmPriceDto
پایدار
POST
/api/OM/v4/Pricing/WithAddressId
دریافت قیمت (با آی دی آدرس های تعریف شده)
OmPriceWithAddressDto
پایدار
POST
/api/OM/v4/Pricing/WithOriginAddressId
دریافت قیمت (با آی دی آدرس مبدا از تعریف شده)
OmPriceWithOriginAddressDto
پایدار
POST
/api/OM/v4/Pricing/GetServicesBetweenCities
دریافت لیست سرویس های بین دو شهر
OmGetServicesBetweenCitiesDto | JetServicesBetweenCitiesListDtoApiResult
پایدار
POST
/api/OM/v4/Pricing/GetServicesList
لیست سرویس ها
OmServiceListDtoListApiResult
جدید

انواع پرداخت 2 اندپوینت

پرداخت‌ها — گروه PaymentType

اندپوینت‌های این گروه

2 اندپوینت
POST
/api/OM/v4/PaymentType/Search
دریافت لیست نوع پرداخت ها
PaymentTypeSearchDto
پایدار
GET
/api/OM/v4/PaymentType/Get
دریافت پرداخت ها با id
PaymentTypeListDto
پایدار

بسته‌بندی 3 اندپوینت

نوع بسته و محتوا — گروه PackingType

اندپوینت‌های این گروه

3 اندپوینت
GET
/api/OM/v4/PackingType/GetPackTypes
دریافت نوع بسته
PublicPackagingGroupListDtoListApiResult
پایدار
GET
/api/OM/v4/PackingType/GetPackingTypes
دریافت بسته بندی ها
OmPackagingTypeResponseOmBaseListDto
پایدار
GET
/api/OM/v4/PackingType/GetPackagingContents
دریافت لیست محتوا
OmPackagingContentResponseOmBaseListDto
پایدار

رهگیری 6 اندپوینت

پیگیری مرسوله — گروه Tracking

اندپوینت‌های این گروه

6 اندپوینت
GET
/api/OM/v4/Tracking/BriefTracking/{trackingInput}
پیگیری مرسوله
JetTrackingBriefListDto
پایدار
GET
/api/OM/v4/Tracking/ByContractCode/{contractCode}
پیگیری مرسوله با کد قرارداد جت
پایدار
GET
/api/OM/v4/Tracking/{orderId}
پیگیری با کد سفارش
پایدار
POST
/api/OM/v4/Tracking/ByTrackingCode
پیگیری چند مرسوله با کد رهگیری
پایدار
POST
/api/OM/v4/Tracking/{traceCode}
پیگیری با کد رهگیری مشتری
پایدار
POST
/api/OM/v4/Tracking/BySecondaryTraceCode/{secondaryTraceCode}
پیگیری با کد رهگیری ثانویه مشتری
پایدار

لاکر 2 اندپوینت

کیوسک و بانچ — گروه Locker

اندپوینت‌های این گروه

2 اندپوینت
POST
/api/v4/Locker/SearchKiosks
جست و جوی کیوسک ها بر اساس مختصات جغرافیایی یا کد شهر -- همراه با فیلتر ابعاد لاکر ها
LockerSearchDto | KiosksListDtoApiResult
Locker
POST
/api/v4/Locker/SearchBunches
جست و جوی بانچ ها بر اساس مختصات جغرافیایی یا کد شهر -- همراه با فیلتر ابعاد لاکر ها
LockerSearchDto | BunchesListDtoApiResult
Locker

مالی 3 اندپوینت

تراکنش — گروه Financial

اندپوینت‌های این گروه

3 اندپوینت
GET
/api/OM/v4/Financial/GetDocuments
دریافت حداکثر 100 تراکنش آخر
پایدار
GET
/api/OM/v4/Financial/GetDocumentsByYear
دریافت تراکنش ها بر اساس سال مالی
پایدار
GET
/api/OM/v4/Financial/GetDocumentById
دریافت جزییات تراکنش مالی
OmVoucherListDto
پایدار

تیکتینگ 6 اندپوینت

تیکت و پاسخ — گروه Ticketing

اندپوینت‌های این گروه

6 اندپوینت
GET
/api/OM/v4/Ticketing
لیست تیکت ها
OmTicketListDtoOmBaseListDto
پایدار
POST
/api/OM/v4/Ticketing
ثبت تیکت
OmTicketCuDto
پایدار
POST
/api/OM/v4/Ticketing/Answer
ثبت پاسخ تیکت
OmTicketResponseCuDto
پایدار
GET
/api/OM/v4/Ticketing/{id}
دریافت جزییات با شماره تیکت
OmGetTicketByIdDto
پایدار
GET
/api/OM/v4/Ticketing/GetByOrderId/{orderId}
دریافت تیکت های مرتبط با یک سفارش
OmGetTicketByIdDto
پایدار
GET
/api/OM/v4/Ticketing/GetDepartments
دریافت لیست دپارتمان ها
OmTicketCategoryListDtoOmBaseListDto
پایدار

شهرها 3 اندپوینت

لیست شهرها — گروه Cities

اندپوینت‌های این گروه

3 اندپوینت
GET
/api/OM/v4/Cities
دریافت لیست شهرها
پایدار
GET
/api/OM/v4/Cities/plusstate
دریافت لیست شهرها به همراه نام استان
پایدار
GET
/api/OM/v4/Cities/BranchCities
دریافت لیست شهرهای دارای نمایندگی فعال
پایدار

استان‌ها 1 اندپوینت

استان‌های ایران — گروه States

اندپوینت‌های این گروه

1 اندپوینت
GET
/api/OM/v4/States
دریافت لیست استان های ایران
پایدار

ویرایش مشتری حقیقی 1 اندپوینت

مشتری حقیقی — گروه ActualCustomers

اندپوینت‌های این گروه

1 اندپوینت
PUT
/api/OM/v4/customers/actual
ویرایش مشتری حقیقی
OmUpdateActualCustomerDto
پایدار
نسخه پایدار قبلی (Stable) • بر اساس OpenAPI 3.0.1 رسمی

مستندات API نسخه ۳ (V3)

نسخه سوم API تیپاکس با ۱۰۵ اندپوینت در ۲۳ گروه، شامل باکس لاین (Box Line)، لاکر، Webhook، تیکتینگ، تراکنش‌های مالی و سرویس‌های اکوپک. تمام جزئیات و جداول این نسخه در همین صفحه نمایش داده شده است.

Base URL (پروداکشن)omapi.tipax.ir
Base URL (تست)omtestapi.tipax.ir
تعداد اندپوینت۱۰۵
Document UI V3 Swagger V3

سه روش ورود

token، tokenwithphonenumber، RefreshToken

باکس لاین (Box Line)

۵ اندپوینت مجزا (Booking)

لاکر

جستجوی کیوسک و بانچ

Webhook رویداد

مدیریت کال‌بک سفارش

مالی و تراکنش

۱۰۰ تراکنش آخر و جزئیات سند

تیکتینگ

ثبت و پاسخ تیکت

احراز هویت در V3

۱
ثبت‌نام در https://etipaxco.com/register و ورود به https://etipaxco.com/login
۲
دریافت apiKey از پروفایل کسب‌وکار در پنل
۳
ارسال POST به https://omapi.tipax.ir/api/OM/v3/Account/token با username، password، apiKey
۴
ارسال هدر Authorization: Bearer YOUR_ACCESS_TOKEN در تمام درخواست‌ها
دسترسی سریع به ۲۳ گروه:
احراز هویت مدیریت مشتری ویرایش مشتری مدیریت آدرس ثبت سفارش باکس لاین مرسولات بسته‌های مشتری وضعیت مرسولات نوع مرسوله محاسبه هزینه انواع پرداخت بسته‌بندی محتوای بسته رهگیری لاکر Webhook تاریخچه Webhook مالی تیکتینگ زمان‌بندی شهرها استان‌ها

جزئیات و جداول API V3 (۲۳ گروه، ۱۰۵ اندپوینت)

احراز هویت 3 اندپوینت

ورود و توکن — گروه Account

اندپوینت‌های این گروه

3 اندپوینت
POST
/api/OM/v3/Account/token
ورود
LoginRequest | LoginResponse
پایدار
POST
/api/OM/v3/Account/tokenwithphonenumber
LoginRequestWithPhoneNumber | LoginResponse
پایدار
POST
/api/OM/v3/Account/RefreshToken
دریافت توکن بروزرسانی
RefreshTokenDto | AccessTokenApiResult
پایدار

نمونه درخواست — احراز هویت

POST /api/OM/v3/Account/token

LoginRequest.json 
{
  "username": "string",
  "password": "string",
  "apiKey": "string"
}

POST /api/OM/v3/Account/RefreshToken

RefreshTokenDto.json 
{
  "token": "string",
  "refreshToken": "string"
}

مدیریت مشتری 20 اندپوینت

مشتری، اعتبار، شعب — گروه Customers

اندپوینت‌های این گروه

20 اندپوینت
GET
/api/OM/v3/Customers
دریافت مشتری جاری
OmCustomerListDto
پایدار
GET
/api/OM/v3/Customers/Credit
دریافت اعتبار مشتری
پایدار
GET
/api/OM/v3/Customers/Wallet
دریافت موجودی کیف پول
پایدار
POST
/api/OM/v3/Customers/RechargeWallet
شارژ کیف پول
OmPaymentUrlCuDto | OmPaymentUrlListDto
پایدار
GET
/api/OM/v3/Customers/Remain
دریافت مانده حساب
پایدار
GET
/api/OM/v3/Customers/mycustomers/{id}
دریافت مشتری من
OmClientListDto
پایدار
GET
/api/OM/v3/Customers/myproducts
دریافت لیست محصولات من
CustomerProductListDtoOmBaseListDto
پایدار
GET
/api/OM/v3/Customers/mycustomers
دریافت لیست مشتریان من
OmClientsListDtoOmBaseListDto
پایدار
GET
/api/OM/v3/Customers/mySubstations
دریافت لیست شعب من
CustomerSubstationListDtoOmBaseListDto
پایدار
POST
/api/OM/v3/Customers/CreateMySubstation
افزودن به لیست شعب من
CustomerSubstationCuDto
پایدار
POST
/api/OM/v3/Customers/DisableMySubstation
غیرفعال کردن شعبه من
پایدار
POST
/api/OM/v3/Customers/EnableMySubstation
فعال کردن شعبه من
پایدار
GET
/api/OM/v3/Customers/{customerId}/GetCustomerCreatedByCustomer
CustomerListDtoListApiResult
پایدار
GET
/api/OM/v3/Customers/{substationId}/GetCustomersOfSubstation
CustomerListDtoListApiResult
پایدار
POST
/api/OM/v3/Customers/RegisterForPanel
SSORegisterWithEmailAndNoPeopleRequest | SSORegisterResponseForPanelApiResult
پایدار
GET
/api/OM/v3/Customers/GetMyCustomers/{substationCode}
گرفتن لیست مشتری های شعبه ی من
OmMyCustomerListDtoListApiResult
پایدار
POST
/api/OM/v3/Customers/ApprovePhoneNumber
SSOUpdateRequest | SSORegisterResponseForPanelApiResult
پایدار
POST
/api/OM/v3/Customers/ValidateUserForPanel
SSOUserValidationDto | SSOTokenApiResult
پایدار
POST
/api/OM/v3/Customers/ApprovePhoneNumberCode
SSOUserValidationDto | AccessTokenApiResult
پایدار
POST
/api/OM/v3/Customers/ResendSMSForApprovePhoneNumber
UserIdDto | ApiResult
پایدار
POST
/api/OM/v3/Customers/GetTotalCustomerProducts
UserIdDto | ApiResult
پایدار

ثبت سفارش Fulfillment در Api

در سفارش‌های Fulfillment، علاوه بر اطلاعات معمول بسته، اطلاعات محصولات داخل بسته نیز در فیلد products ارسال می‌شود.

مرحله ۱: دریافت محصولات مشتری

ابتدا برای دریافت id و branchId محصولات مشتری، سرویس زیر فراخوانی می‌شود:

POST https://omapi.tipax.ir/api/OM/v3/Customers/GetTotalCustomerProducts

Request Body:

GetTotalCustomerProducts.json 
{}

از پاسخ این سرویس، اطلاعات محصول شامل id و branchId دریافت می‌شود.

مرحله ۲: ثبت سفارش Fulfillment

پس از انتخاب محصول و مشخص شدن تعداد، سفارش از طریق Endpoint زیر ثبت می‌شود:

POST https://omapi.tipax.ir/api/OM/v3/Orders

نمونه Request

FulfillmentOrder.json 
{
  "packages": [
    {
      "origin": {
        "cityId": 1262,
        "fullAddress": "آدرس فرستنده پلاک23",
        "latitude": 35.70526226,
        "longitude": 51.38477325,
        "beneficiary": {
          "fullName": "امیر",
          "mobile": "09121234567",
          "floor": "2",
          "unit": "4",
          "postalCode": "1234567891",
          "description": "test"
        }
      },
      "destination": {
        "cityId": 1262,
        "fullAddress": "آدرس گیرنده پلاک 444",
        "latitude": 35.70526226,
        "longitude": 51.38477325,
        "floor": "12",
        "unit": "32",
        "postalCode": "8529637410",
        "beneficiary": {
          "fullName": "امیرعلی",
          "mobile": "09331234567"
        }
      },
      "customParcelTitle": "TEST",
      "weight": 1,
      "packageValue": 10000000,
      "length": 30,
      "width": 40,
      "height": 45,
      "packageContentId": 9,
      "packingId": 10,
      "packType": 20,
      "serviceId": 1,
      "paymentType": 20,
      "pickupType": 10,
      "distributionType": 10,
      "cod": 0,
      "products": [
        {
          "id": 401,
          "branchId": 432,
          "count": 1
        }
      ]
    }
  ]
}

بخش Products

فیلد products مشخص می‌کند چه محصولی از موجودی Fulfillment در این سفارش استفاده شود.

products.json 
"products": [
  {
    "id": 401,
    "branchId": 432,
    "count": 1
  }
]
فیلدتوضیح
idشناسه محصول که از GetTotalCustomerProducts دریافت می‌شود
branchIdشناسه شعبه مرتبط با محصول که از GetTotalCustomerProducts دریافت می‌شود
countتعداد محصول موردنیاز در سفارش
نکته: مقادیر id و branchId نمونه هستند و در پیاده‌سازی واقعی باید از پاسخ سرویس GetTotalCustomerProducts استفاده شوند.

ویرایش مشتری 1 اندپوینت

مشتری حقیقی — گروه ActualCustomers

اندپوینت‌های این گروه

1 اندپوینت
PUT
/api/OM/v3/customers/actual
ویرایش مشتری حقیقی
OmUpdateActualCustomerDto
پایدار

مدیریت آدرس 6 اندپوینت

آدرس و پلیگون — گروه Addresses

اندپوینت‌های این گروه

6 اندپوینت
POST
/api/OM/v3/Addresses
افزودن آدرس برای مشتری جاری (آدرس کسب و کار)
OmAddressCuDto | PeopleAddressesListDto
پایدار
GET
/api/OM/v3/Addresses
دریافت لیست آدرس های کاربر(آدرس های کسب و کار)
پایدار
POST
/api/OM/v3/Addresses/Book
افزودن آدرس به دفترچه آدرس
PeopleAddressCuDto | PeopleAddressesListDto
پایدار
GET
/api/OM/v3/Addresses/Book
دریافت دفترچه آدرس کاربر
پایدار
GET
/api/OM/v3/Addresses/{id}
در یافت آدرس با کد آدرس
PeopleAddressesListDto
پایدار
GET
/api/OM/v3/Addresses/GetBranchPolygonByPoint
دریافت نزدیکترین پلیگون نمایندگی براساس مختصات طول و عرض جغرافیایی
GisBranchListDtoApiResult
پایدار

ثبت سفارش 16 اندپوینت

۱۶ روش ثبت سفارش — گروه Orders

اندپوینت‌های این گروه

16 اندپوینت
POST
/api/OM/v3/Orders
ثبت سفارش
OmOrderCuDto | OmOrderListDto
پایدار
POST
/api/OM/v3/Orders/OrderForAnotherCustomer
ثبت سفارش توسط مشتری برای یک مشتری دیگر
OmOrderCuByAnotherCustomerDto | OmOrderListDto
پایدار
POST
/api/OM/v3/Orders/GroupOrder
ثبت سفارش گروهی (اکسل)
OmOrderCuDto | OmOrderListDto
گروهی
POST
/api/OM/v3/Orders/WithPreDefinedAddresses
ثبت سفارش با آدرس های از پیش تعریف شده
OmOrderWithAddressCuDto | OmOrderListDto
پایدار
POST
/api/OM/v3/Orders/WithPreDefinedOrigin
ثبت سفارش با مبدأ از پیش تعریف شده
OmOrderWithOriginAddressCuDto | OmOrderListDto
پایدار
POST
/api/OM/v3/Orders/PluginOrder
ثبت سفارش از طریق پلاگین
OmOrderWithOriginAddressCuDto | OmOrderListDto
پایدار
POST
/api/OM/v3/Orders/WithCoordinates
ثبت سفارش با مختصات جغرافیایی
OmOrderWithLocationCuDto | OmOrderListDto
پایدار
POST
/api/OM/v3/Orders/WithDiscount
ثبت سفارش با استفاده از کد تخفیف
OmOrderCuDto | OmOrderListDto
پایدار
GET
/api/OM/v3/Orders/GetOrderAmountByOrderId/{orderId}
دریافت مبلغ سفارش
پایدار
POST
/api/OM/v3/Orders/GetSumTotalAmountByOrderIds
دریافت جمع هزینه ی سفارش ها(تومان)
پایدار
POST
/api/OM/v3/Orders/MyTipaxOrder
ثبت سفارش مای تیپاکس
MyTipaxOrderRegisterCuDto | OmOrderListDtoApiResult
پایدار
POST
/api/OM/v3/Orders/CancelOrder/{orderId}
ابطال سفارش
OmInvalidatedBarcodesListDtoApiResult
پایدار
POST
/api/OM/v3/Orders/PreOrder
ثبت پیش سفارش
OmPreOrderCuDto | OmOrderListDto
جدید
POST
/api/OM/v3/Orders/CancelOrderByCode/{secondaryTraceCode}
ابطال سفارش با کد ثانویه سفارش
OmInvalidatedBarcodesListDtoApiResult
پایدار
POST
/api/OM/v3/Orders/QueueOrder
ثبت سفارش در صف
OmQueueOrderCuDto | OmQueuedOrderListDtoApiResult
جدید
POST
/api/OM/v3/Orders/BulkQueueOrder
ثبت سفارش در صف به صورت گروهی
OmBulkQueueOrderCuDto | OmBulkQueuedOrderListDtoApiResult
گروهی

نمونه درخواست — ثبت سفارش

POST /api/OM/v3/Orders

OmOrderCuDto.json 





{
  "packages": [
    {
      "origin": {
        "cityId": 1262,
        "fullAddress": "آدرس فرستنده پلاک23",
        "latitude": 51.8302611199163,
        "longitude": 35.4438412913701,
        "beneficiary": {
          "fullName": "امیر",
          "mobile": "09121234567",
          "floor": "2",
          "unit": "4",
          "postalCode": "1234567891",
          "description": "test"
        }
      },
      "destination": {
        "cityId": 1293,
        "fullAddress": "آدرس گیرنده پلاک 444",
        "latitude": 51.78712623,
        "longitude": 35.42576206,
        "floor": "12",
        "unit": "32",
        "postalCode": "8529637410",
        "beneficiary": {
          "fullName": "امیرعلی",
          "mobile": "09331234567"
        }
      },
      "customParcelTitle": "TESTL",
      "weight": 1,
      "packageValue": 10000000,
      "length": 40,
      "width": 30,
      "height": 5,
      "packingId": 522,
      "packageContentId": 36,
      "packType": 70,
      "paymentType": 20,
      "pickupType": 20,
      "distributionType": 10,
      "serviceId": 7,
      "cod": 0,
      "cashAmount": 0
    }
  ],
  "traceCode": "MP11101492",
  "secondaryTraceCode": "MP85214798910",
  "discountCode": null,
  "successCallbackUrl": "",
  "failureCallbackUrl": ""
}

POST /api/OM/v3/Orders/WithCoordinates

OmOrderWithCoordinatesCuDto.json 

{
  "latitude": "36.5461926",
  "longitude": "52.6783361",
  "no": "string",
  "packages": [
    {
      "destination": {
        "cityId": 1262,
        "fullAddress": "شهرک تست خیابان تست کوچه تست",
        "floor": "2",
        "unit": "45",
        "postalCode": "1234567891",
        "latitude": "35.71957113",
        "longitude": "51.37508023",
        "no": "3",
        "description": "توضیح تست",
        "beneficiary": {
          "phone": "093518880888",
          "fullName": "تست تستی",
          "mobile": "093518880888"
        }
      },
      "isUnsual": false,
      "weight": 4,
      "packageValue": 450000000,
      "length": 35,
      "width": 45,
      "height": 55,
      "packingId": 11,
      "packageContentId": 9,
      "packType": 20,
      "description": "Test",
      "serviceId": 4,
      "enableLabelPrivacy": true,
      "paymentType": 20,
      "pickupType": 20,
      "distributionType": 20,
      "cod": 0,
      "cashAmount": 0,
      "customParcelTitle": "TEST-SHENASE"
    }
  ],
  "traceCode": "TEST547698",
  "secondaryTraceCode": "TS3456678",
  "discountCode": ""
}

باکس لاین (LTL) 5 اندپوینت

ثبت باکس لاین — گروه Booking

اندپوینت‌های این گروه

5 اندپوینت
POST
/api/OM/v3/Booking/Register
ثبت سفارش جدید از نوع باکس لاین (Box Line) در سامانه
BookingCuDto | BookingListDtoApiResult
Box Line
POST
/api/OM/v3/Booking/Search
جستجوی سفارش‌های باکس لاین با استفاده از فیلترهای اختیاری
BookingV3SearchDto | BookingListDtoIPagedListApiResult
Box Line
POST
/api/OM/v3/Booking/GetWorkingDates
دریافت لیست تاریخ‌های کاری (ساعات مجاز جمع‌آوری یا تحویل) بر اساس آدرس، تاریخ شروع و مهلت زمانی
GetWorkingDatesDto | BookingWorkingDateListDtoListApiResult
Box Line
POST
/api/OM/v3/Booking/Cancel
ابطال سفارش باکس لاین توسط مشتری
BookingStatusUpdateDto | BookingListDtoApiResult
Box Line
POST
/api/OM/v3/Booking/UpdateByCustomer/{bookingId}
ویرایش سفارش باکس لاین توسط مشتری
BookingUpdateDto | BookingListDtoApiResult
Box Line

نمونه درخواست — باکس لاین

POST /api/OM/v3/Booking/Register

BookingCuDto.json 

{
  "pickupDate": "1405/05/10",
  "deadlineDays": 2,
  "bookingParcels": [
    {
      "parcelValue": "500000000",
      "weight": "30",
      "description": "Refrigerator sample",
      "packagingTypeId": 509,
      "senderClientId": 5877661,
      "receiverClientId": 71012065,
      "senderAddressesId": 86035238,
      "receiverAddressesId": 85581549,
      "paymentTypeId": 10,
      "pickupTypeId": 10,
      "deliveryTypeId": 10,
      "packagingContentId": 11
    }
  ],
  "WorkingDates": [
    {
      "date": "1405/05/10",
      "start": "09:00",
      "end": "15:00",
      "Type": "Origin"
    },
    {
      "date": "1405/05/11",
      "start": "09:00",
      "end": "15:00",
      "Type": "Origin"
    },
    {
      "date": "1405/05/10",
      "start": "02:40",
      "end": "12:00",
      "Type": "Destination"
    },
    {
      "date": "1405/05/11",
      "start": "02:40",
      "end": "12:00",
      "Type": "Destination"
    }
  ]
}

مرسولات 9 اندپوینت

جستجو و ابطال — گروه Parcels

اندپوینت‌های این گروه

9 اندپوینت
GET
/api/OM/v3/Parcels/GetByOrderId/{orderId}
دریافت لیست مرسوله ها بر اساس شماره سفارش
OmParcelDtoOmBaseListDto
پایدار
GET
/api/OM/v3/Parcels/PaymentType/{trackingCode}
نوع پرداخت
پایدار
PUT
/api/OM/v3/Parcels/Cancel/{trackingCode}
ابطال مرسوله
پایدار
GET
/api/OM/v3/Parcels/GetAmountByTrackingCode/{trackingCode}
دریافت مبلغ مرسوله با کد رهگیری ای تیپاکس
OmOrderCostBriefListDto
پایدار
POST
/api/OM/v3/Parcels/GetSumTotalAmountByTrackingCodes
دریافت جمع هزینه ی مرسوله ها(تومان)
پایدار
GET
/api/OM/v3/Parcels/GetAmountByContractCode/{contractCode}
دریافت مبلغ مرسوله با کد قرارداد جت
OmOrderCostBriefListDto
پایدار
GET
/api/OM/v3/Parcels/GetPriceDetailByTrackingCode/{trackingCode}
دریافت جزییات مبلغ مرسوله با کد کد رهگیری ای تیپاکس
OmOrderCostListDto
پایدار
GET
/api/OM/v3/Parcels/GetPriceDetailByContractCode/{contractCode}
دریافت جزییات مبلغ مرسوله با کد قرارداد جت
OmOrderCostListDto
پایدار
POST
/api/OM/v3/Parcels/Search
دریافت لیست مرسوله هایی که در دست جمع آوری هستند
ParcelSearchByBranchDto | ParcelListDtoListApiResult
پایدار

بسته‌های مشتری 2 اندپوینت

دفترچه — گروه ParcelBooks

اندپوینت‌های این گروه

2 اندپوینت
GET
/api/OM/v3/ParcelBooks
دریافت لیست بسته های تعریف شده مشتری
OmCustomerPackageResponseOmBaseListDto
پایدار
POST
/api/OM/v3/ParcelBooks
افزودن بسته جدید به لیست بسته های مشتری
OmCreateCustomerPackageRequest | OmCreateCustomerPackageResponse
پایدار

وضعیت مرسولات 2 اندپوینت

وضعیت و رویداد — گروه ParcelStatus

اندپوینت‌های این گروه

2 اندپوینت
GET
/api/OM/v3/ParcelStatus
لیست وضعیت ها
OmParcelStatusListDtoListApiResult
پایدار
GET
/api/OM/v3/ParcelStatus/GetEventWithStatus
لیست رویداد ها
ParcelEventTypeListDtoListApiResult
پایدار

نوع مرسوله 2 اندپوینت

انواع مرسوله — گروه ParcelType

اندپوینت‌های این گروه

2 اندپوینت
POST
/api/OM/v3/ParcelType/Search
دریافت لیست نوع مرسوله ها
ParcelTypeSearchDto
پایدار
GET
/api/OM/v3/ParcelType/Get
دریافت مرسوله ها با id
ParcelTypeListDto
پایدار

محاسبه هزینه 7 اندپوینت

قیمت و سرویس — گروه Pricing

اندپوینت‌های این گروه

7 اندپوینت
POST
/api/OM/v3/Pricing
دریافت قیمت
OmPriceDto
پایدار
POST
/api/OM/v3/Pricing/WithAddressId
دریافت قیمت (با آی دی آدرس های تعریف شده)
OmPriceWithAddressDto
پایدار
POST
/api/OM/v3/Pricing/WithOriginAddressId
دریافت قیمت (با آی دی آدرس مبدا از تعریف شده)
OmPriceWithOriginAddressDto
پایدار
POST
/api/OM/v3/Pricing/GetForAllServices
دریافت قیمت برای تمامی سرویس ها
OmPriceDto
پایدار
POST
/api/OM/v3/Pricing/WithAddressIdForAllServices
دریافت قیمت با آدرس های تعریف شده برای تمامی سرویس ها
OmPriceWithAddressDto
پایدار
POST
/api/OM/v3/Pricing/WithOriginAddressIdForAllServices
دریافت قیمت با آدرس مبدا تعریف شده برای تمامی سرویس ها
OmPriceWithOriginAddressDto
پایدار
POST
/api/OM/v3/Pricing/GetServicesBetweenCities
دریافت لیست سرویس های بین دو شهر
OmGetServicesBetweenCitiesDto | JetServicesBetweenCitiesListDtoApiResult
پایدار

نمونه درخواست — محاسبه هزینه

POST /api/OM/v3/Pricing

OmPriceDto.json 

{
  "packageInputs": [
    {
      "origin": {
        "cityId": 1262
      },
      "destination": {
        "cityId": 1262
      },
      "weight": 2,
      "packageValue": 2222222,
      "length": 2,
      "width": 2,
      "height": 2,
      "packingId": 7,
      "packageContentId": 520,
      "packType": 20,
      "paymentType": 20,
      "pickupType": 0,
      "distributionType": 10,
      "serviceId": 7

    }
  ]
}

انواع پرداخت 2 اندپوینت

پرداخت — گروه PaymentType

اندپوینت‌های این گروه

2 اندپوینت
POST
/api/OM/v3/PaymentType/Search
دریافت لیست نوع پرداخت ها
PaymentTypeSearchDto
پایدار
GET
/api/OM/v3/PaymentType/Get
دریافت پرداخت ها با id
PaymentTypeListDto
پایدار

بسته‌بندی 1 اندپوینت

بسته‌بندی — گروه PackingPrices

اندپوینت‌های این گروه

1 اندپوینت
GET
/api/OM/v3/PackingPrices
دریافت بسته بندی ها
OmPackagingTypeResponseOmBaseListDto
پایدار

محتوای بسته 1 اندپوینت

محتوا — گروه PackContentRates

اندپوینت‌های این گروه

1 اندپوینت
GET
/api/OM/v3/PackContentRates
دریافت لیست محتوا
OmPackagingContentResponseOmBaseListDto
پایدار

رهگیری 6 اندپوینت

پیگیری — گروه Tracking

اندپوینت‌های این گروه

6 اندپوینت
GET
/api/OM/v3/Tracking/BriefTracking/{trackingInput}
پیگیری مرسوله
JetTrackingBriefListDto
پایدار
GET
/api/OM/v3/Tracking/ByContractCode/{contractCode}
پیگیری مرسوله با کد قرارداد جت
پایدار
GET
/api/OM/v3/Tracking/{orderId}
پیگیری با کد سفارش
پایدار
POST
/api/OM/v3/Tracking/ByTrackingCode
پیگیری چند مرسوله با کد رهگیری
پایدار
POST
/api/OM/v3/Tracking/{traceCode}
پیگیری با کد رهگیری مشتری
پایدار
POST
/api/OM/v3/Tracking/BySecondaryTraceCode/{secondaryTraceCode}
پیگیری با کد رهگیری ثانویه مشتری
پایدار

لاکر 2 اندپوینت

کیوسک و بانچ — گروه Locker

اندپوینت‌های این گروه

2 اندپوینت
POST
/api/v3/Locker/SearchKiosks
جست و جوی کیوسک ها بر اساس مختصات جغرافیایی یا کد شهر -- همراه با فیلتر ابعاد لاکر ها
LockerSearchDto | KiosksListDtoApiResult
Locker
POST
/api/v3/Locker/SearchBunches
جست و جوی بانچ ها بر اساس مختصات جغرافیایی یا کد شهر -- همراه با فیلتر ابعاد لاکر ها
LockerSearchDto | BunchesListDtoApiResult
Locker

نمونه درخواست — لاکر


Webhook 4 اندپوینت

مدیریت کال‌بک — گروه CustomerWebhook

اندپوینت‌های این گروه

4 اندپوینت
GET
/api/OM/v3/CustomerWebhook
Returns all CustomerWebhooks
CustomerWebhookListDtoApiResult
پایدار
POST
/api/OM/v3/CustomerWebhook
Creates a CustomerWebhook
CustomerWebhookCuDto | CustomerWebhookListDtoApiResult
پایدار
PUT
/api/OM/v3/CustomerWebhook
Updates a CustomerWebhook by unique id
CustomerWebhookCuDto | CustomerWebhookListDtoApiResult
پایدار
PUT
/api/OM/v3/CustomerWebhook/SoftDelete/{id}
ApiResult
پایدار

نمونه درخواست — Webhook


تاریخچه Webhook 2 اندپوینت

گزارش — گروه CustomerWebhookHistory

اندپوینت‌های این گروه

2 اندپوینت
POST
/api/OM/v3/CustomerWebhookHistory/GetAll
Returns all CustomerWebhookHistories
CustomerWebhookHistorySearchDto | CustomerWebhookHistoryListDtoListApiResult
پایدار
GET
/api/OM/v3/CustomerWebhookHistory/Recent/{customerId}
CustomerWebhookHistoryListDtoListApiResult
پایدار

مالی 3 اندپوینت

تراکنش — گروه Financial

اندپوینت‌های این گروه

3 اندپوینت
GET
/api/OM/v3/Financial/GetDocuments
دریافت حداکثر 100 تراکنش آخر
پایدار
GET
/api/OM/v3/Financial/GetDocumentsByYear
دریافت تراکنش ها بر اساس سال مالی
پایدار
GET
/api/OM/v3/Financial/GetDocumentById
دریافت جزییات تراکنش مالی
OmVoucherListDto
پایدار

تیکتینگ 6 اندپوینت

تیکت — گروه Ticketing

اندپوینت‌های این گروه

6 اندپوینت
GET
/api/OM/v3/Ticketing
لیست تیکت ها
OmTicketListDtoOmBaseListDto
پایدار
POST
/api/OM/v3/Ticketing
ثبت تیکت
OmTicketCuDto
پایدار
POST
/api/OM/v3/Ticketing/Answer
ثبت پاسخ تیکت
OmTicketResponseCuDto
پایدار
GET
/api/OM/v3/Ticketing/{id}
دریافت جزییات با شماره تیکت
OmGetTicketByIdDto
پایدار
GET
/api/OM/v3/Ticketing/GetByOrderId/{orderId}
دریافت تیکت های مرتبط با یک سفارش
OmGetTicketByIdDto
پایدار
GET
/api/OM/v3/Ticketing/GetDepartments
دریافت لیست دپارتمان ها
OmTicketCategoryListDtoOmBaseListDto
پایدار

زمان‌بندی 1 اندپوینت

برنامه روزانه — گروه TimeTable

اندپوینت‌های این گروه

1 اندپوینت
GET
/api/v3/TimeTable/GetNextDayTimeTableSchedule
TimeTableScheduleApiResult
پایدار

شهرها 3 اندپوینت

شهرها و استان‌ها — گروه Cities

اندپوینت‌های این گروه

3 اندپوینت
GET
/api/OM/v3/Cities
دریافت لیست شهرها
پایدار
GET
/api/OM/v3/Cities/plusstate
دریافت لیست شهرها به همراه نام استان
پایدار
GET
/api/OM/v3/Cities/BranchCities
دریافت لیست شهرهای دارای نمایندگی فعال
پایدار

استان‌ها 1 اندپوینت

استان — گروه States

اندپوینت‌های این گروه

1 اندپوینت
GET
/api/OM/v3/States
دریافت لیست استان های ایران
پایدار
سامانه ویژه شعب و نمایندگی‌ها

سامانه قبول مرسولات تیپاکس

این بخش در حال آماده‌سازی است. به‌زودی مستندات کامل سامانه قبول مرسولات تیپاکس برای اپراتورهای شعب و نمایندگی‌ها در این صفحه ارائه خواهد شد.

وضعیتدر حال آماده‌سازی
تاریخ انتشاربه‌زودی

دیتای مستندات هنوز موجود نیست

مستندات و اندپوینت‌های سامانه قبول به‌محض دریافت فایل OpenAPI رسمی، در این صفحه قرار خواهند گرفت. در صورت داشتن فایل OpenAPI برای سامانه قبول، آن را برای ما ارسال کنید تا اضافه شود.

انواع بسته‌بندی

جدول کامل انواع بسته‌بندی تیپاکس شامل شناسه، ابعاد، وزن و نوع بسته. این مقادیر در فیلد packingId در زمان ثبت سفارش استفاده می‌شوند.

لیست بسته‌بندی‌ها

packingIdminWeightminHeightminWidthminLength maxWeightmaxHeightmaxWidthmaxLength heightwidthlengthpackTypetitle
Loading data...

دسته‌بندی محتوای بسته

لیست انواع محتوای قابل ارسال با شناسه‌های مرتبط. این شناسه در فیلد packageContentId استفاده می‌شود.

دسته‌بندی‌ها

idpackTypetitle
Loading data...

پارامترها و توضیحات

جدول کامل پارامترهای استفاده‌شده در API تیپاکس. هر پارامتر شامل نام انگلیسی و توضیح فارسی است. برای جستجو از کادر بالای جدول استفاده کنید.

جدول پارامترها

parameter description
Username omapi.tipax.irنام کاربری در
Password omapi.tipax.irرمز عبور در
APIkey کلید ای‌تیپاکس API
refreshToken توکن به‌روزرسانی (دریافت شده هنگام ساخت توکن قبلی)
id آیدی کاربر
firstName نام
lastName نام خانوادگی
nationalCode کدملی
email ایمیل
phone تلفن
mobile شماره تلفن همراه
description توضیحات
title عنوان آدرس
cityId آیدی شهر
districtId منطقه
mainStreet1 خیابان اصلی
sideStreet1 خیابان فرعی
mainAlley1 کوچه اصلی
sideAlley1 کوچه فرعی
latitude طول جغرافیایی
longitude عرض جغرافیایی
postalCode کدپستی
unit واحد
floor طبقه
no پلاک
isDefault
personId آیدی کاربر
plaque پلاک
fullAddress آدرس کامل
beneficiary.phone شماره تلفن فرستنده
beneficiary.fullName نام و نام خانوادگی فرستنده
beneficiary.mobile موبایل فرستنده
destination.beneficiary.phone شماره تلفن گیرنده
destination.beneficiary.fullName نام و نام خانوادگی گیرنده
destination.beneficiary.mobile موبایل گیرنده
weight وزن بسته
packageValue ارزش بسته
length طول بسته
width عرض بسته
height ارتفاع بسته
packingId آی‌دی بسته‌بندی
packType نوع بسته‌بندی
parcelTypeId آیدی نوع بسته
parcelBookId آیدی بسته‌های تعریف شده مشتری
serviceId نوع سرویس
enableLabelPrivacy چاپ جزئیات فرستنده و گیرنده بر روی لیبل
paymentType نوع پرداخت
pickupType نوع جمع‌آوری
cod COD مبلغ
cashAmount مبلغ نقدی
barcode بارکد
secondaryTraceCode کد رهگیری اختصاصی ثانویه
discountCode کد تخفیف
originId ثبت کرده‌ایم addressbook آیدی آدرس مبدا که از قبل در
destinationId ثبت کرده‌ایم addressbook آیدی آدرس مقصد که از قبل در
originId ثبت کرده‌ایم addressbook آیدی آدرس مبدا که از قبل در
title عنوان بسته
length طول بسته
width عرض بسته
height ارتفاع بسته
packageValue ارزش بسته پستی
weight وزن بسته
packType پاکت:10 بسته :20 مینی پک:50
packageContentId (packContentRate تمامی مقادیر ممکن در متد) محتویات مثل: عمومی، شکستنی
packingId (PackingPrices تمامی مقادیر ممکن در متد) نوع بسته‌بندی مثال: کارتن سایز 1
isUnusual (true/false) آیا بسته غیراستاندارد است
origin.cityId آیدی شهر مبدا
destination.cityId آیدی شهر مقصد
weight وزن بسته
packageValue ارزش بسته پستی
length طول بسته
width عرض بسته
height ارتفاع بسته
packingId (تمامی مقادیر ممکن در متد PackingPrices) نوع بسته بندی مثال : کارتن سایز 1
parcelBookId آیدی بسته های تعریف شده مشتری
isUnusual آیا بسته غیر استاندارد است (true/false)
packType نوع – 10:پاکت – 20:بسته- 50:مینی پک
paymentType نوع پرداخت- 10:سمت فرستنده-اعتباری – 20:سمت گیرنده -پسکرایه
– 30:سمت گیرنده-پرداخت در محل- 40:سمت فرستنده-پرداخت در محل-
50:سمت فرستنده-پرداخت از کیف پول 80-سمت فرستنده-نقدی (تمامی مقادیر ممکن در متد PaymentType)
pickupType نوع جمع آوری - 10:جمع آوری در محل مشتری – 20:جمع آوری در نمایندگی
distributionType نوع تحویل- 10:تحویل در محل مشتری – 20:تحویل در نمایندگی
Serviced نوع سرویس- 1:ارسال زمینی همان روز – 2:ارسال زمینی یک روزه- 3:ارسال زمینی دو روزه- 5:اکسپرس ویژه بین شهری- 6:"بین الملل- 7:اکسپرس درون شهری
customerId کد مشتری
departmentId (GetDepartments تمامی مقادیر ممکن در متد) آیدی دپارتمان
priorityId الویت
subject موضوع
Text متن پاسخ تیکت
ticketId آیدی تیکتی که می‌خواهیم به آن پاسخ دهیم
contractCode کد قرارداد
orderNo شماره سفارش
contractKindName نوع قرارداد
dispatchCount تعداد بسته‌های ارسالی
contractStatusName وضعیت قرارداد
contractStatusId آیدی وضعیت قرارداد
dispatchValue ارزش بسته‌ها
contractInternalTime تاریخ شمسی ثبت سفارش
terminateUserFullName نام کاربر ابطال‌کننده سفارش
terminateDescribe دلیل ابطال
shippingCost هزینه حمل‌ونقل
specialService سرویس ویژه
packageService هزینه بسته‌بندی
smsCost هزینه پیامک
tax مالیات
discount تخفیف
hasCOD است COD آیا سفارش
cod COD مبلغ
finalAmount مبلغ نهایی
cashAmount مبلغ نقدی
payInPlaceAmount مبلغ پس‌کرایه
prePaidAmount مبلغ پیش پرداخت
paymentKindName نوع پرداخت
senderFullName نام فرستنده
senderMobileNumber موبایل فرستنده
senderPhoneNumber تلفن فرستنده
phoneNumber تلفن همراه
senderAddress آدرس فرستنده
senderCityName نام شهر فرستنده
totalWeight وزن بسته‌ها
barcode بارکدها
traceCode کد رهگیری مشتری
secondaryTraceCode کد رهگیری ثانویه مشتری
status وضعیت فعلی بسته
statusId آیدی وضعیت بسته
origin آدرس فرستنده
originState استان فرستنده
originCity شهر فرستنده
destination آدرس مقصد
destinationState استان مقصد
destinationCity شهر مقصد
paymentType نوع پرداخت
length طول
width عرض
height ارتفاع
value ارزش
weight وزن
packageType (packagingPrices) آیدی نوع بسته‌بندی
title عنوان نوع بسته‌بندی
packageContentTitle محتویات بسته مثل : عمومی , شکستنی
isFragile آیا بسته شکستنی است؟
parcelStatusHistories تاریخچه وضعیت بسته
jetIdContractAmountInfo کد قرارداد جت
shippingCost هزینه حمل‌ونقل
packageService هزینه بسته‌بندی
tax مالیات
finalAmount مبلغ نهایی
paymentKindName نوع پرداخت
cashAmount مبلغ نقدی
payInPlaceAmount مبلغ پس‌کرایه
organizationalServices خدمات سازمانی
distanceDay تخمین زمان تحویل بسته
nationalId
persianRegistrationDate
registrationNo
economicNo
companyId
customerCode
jetIdCustomer
leadId
clientsId
addressId
cityETipaxId
isIndividual
genderTypeId
homeTownCityId
maritalStatusId
approveId
ReceiverKioskId آیدی کیوسک جهت استفاده از سرویس لاکر پر شود
(برای اطلاعات بیشتر از سرویس لاکر بخش Locker را مطالعه نمایید)
preFix
branchId
modifierId
creatorId
peopleAddressTypeId
frontCallBackUrl
militaryStatusId
religionTypesId
dateOfEmployment
senderAddressId
jetId کد قرارداد جت
inFix
pickupStartTime
pickupEndTime
isDescending
toModificationDate
fromCreationDate
customParcelTitle این پارامتر شناسه فاکتور را تعیین می‌کند. در صورتی که گزارش به‌صورت اکسل دریافت شود، مقدار این پارامتر در ستون شناسه فاکتور نمایش داده خواهد شد
sourceCityId
destinationCityId
creationTime
modificationTime
totalItemCount
pageNumber
pageSize
pageCount
fromModificationDate
toCreationDate
sortBy
recordsPerPage
oldBarcode
newBarcode
bubbleWrapAmount
glueAmount
salaryAmount
postFix
barcodeTypeId
pickupDate
successCallbackUrl
failureCallbackUrl
addressTitle
clientTitle
bubbleWrapAmount
districtManagersOpinion
customerSubstationCode
exclusiveCode
birthDate
idNo
managerName
userId
generatedBarcodeId
otherAddress

انواع سرویس ارسال

سرویس‌های مختلف ارسال تیپاکس شامل سرویس عادی، سیستمی، ویژه، موتوری، سیستمی مقصد و سرویس مرجوعی. شناسه هر سرویس در فیلد serviceId استفاده می‌شود.

لیست سرویس‌ها

idisActivetitle
Loading data...

انواع پرداخت

مدل‌های مختلف پرداخت هزینه ارسال شامل پرداخت سمت فرستنده، سمت گیرنده، نقدی، اعتباری و کیف پول. شناسه در فیلد paymentType استفاده می‌شود.

لیست انواع پرداخت

id title description
10سمت فرستنده - پیش‌پرداختپرداخت در محل مبدا پیش از تحویل
20سمت گیرنده - نقدیپرداخت نقدی توسط گیرنده هنگام تحویل
30سمت گیرنده - پرداخت در محلپرداخت توسط گیرنده در محل دریافت
40سمت فرستنده - پرداخت در محل از اعتبارپرداخت در محل از اعتبار فرستنده
50سمت فرستنده - پرداخت از کیف پولکسر از کیف پول فرستنده
60سمت فرستنده - پرداخت در محل از کیف پولپرداخت در محل از کیف پول فرستنده
80سمت فرستنده - نقدیپرداخت نقدی در مبدا
90سمت فرستنده - اعتبار نمایندگیکسر از اعتبار نمایندگی

شهرها و استان‌ها

لیست کامل شهرها و استان‌های تحت پوشش تیپاکس. برای دریافت لیست سرویس‌های بین دو شهر از ابزار سرویس بین دو شهر استفاده کنید.

جستجوی شهر

id jetId latitude longitude stateTitle stateId title
Loading data...

وضعیت مرسولات

کد وضعیت‌های ممکن برای مرسولات در طول چرخه ارسال. این مقادیر در پاسخ API و رویدادهای مرسوله استفاده می‌شوند.

لیست وضعیت‌ها

id latinTitle title
Loading data...

رویدادهای مرسولات

رویدادهای قابل مشاهده در طول چرخه زندگی یک مرسوله. این رویدادها در پاسخ متد رهگیری (Tracking) قابل دسترسی هستند.

لیست رویدادها

idmodifiercreatormodificationTime creationTimemodificationDatecreationDatemodifierId creatorIdisActiveparcelStatus.idparcelStatus.latinTitle parcelStatus.titlefParcelStatusIdlatinTitletitle
Loading data...

سوالات متداول

پاسخ به سوالات رایج توسعه‌دهندگان درباره API تیپاکس. اگر سوال شما در این لیست نیست با تیم پشتیبانی تماس بگیرید.

1 در نسخه 4 چگونه توکن احراز هویت دریافت کنم؟

دریافت توکن باید از طریق متد POST و آدرس https://igtgatewayapi.tipax.ir/Token و ارسال JSON زیر انجام شود:

{
  "username": "نام کاربری پنل ای تیپاکس شما",
  "password": "رمز عبور پنل ای تیپاکس شما",
  "grant_type": "password" //این بخش را بدون تغییر بگذارید
}
2 وضعیت پارامترهای ثبت زمان جمع‌آوری مرسوله چگونه است؟

در حال حاضر پارامترهای ثبت زمان جمع‌آوری مرسوله در API وجود دارد اما امکان ثبت آن میسر نیست.

3 در جیسون مرتبط با آدرس ها پارامتر peopleAddressTypeId چیست؟

آدرس‌های فرستنده peopleAddressTypeId=1 و آدرس‌های گیرنده peopleAddressTypeId=2 دارند

4 پارامتر EnableLabelPrivacy چیست؟

این پارامتر مشخص می‌کند که آیا جزئیات اطلاعات فرستنده و گیرنده بر روی لیبل چاپ شود (true) یا خیر (false)

5 پارامتر parcelbookId چیست؟

هر مشتری می‌تواند از طریق متد POST و اندپوینت https://omapi.tipax.ir/api/OM/v4/ParcelBooks بسته تعریف کند.
بسته‌هایی که توسط خود مشتری تعریف شده‌اند را می‌توان با استفاده از متد Get و اندپوینت https://omapi.tipax.ir/api/OM/v3/ParcelBooks دریافت کرد.
در ریسپانس این سرویس، برای هر بسته تعریف شده یک id وجود دارد که این مقادیر همان Vlaueهای مجاز برای پارامتر parcelbookId هستند.
نکته مهم در مورد این پارامتر این است که زمانی که در جیسون ارسالی، از این پارامتر استفاده می‌کنید، دیگر لازم نیست پارامترهای مرتبط با ابعاد (طول، عرض و ارتفاع) را ارسال کنید.
اما اگر این پارامتر را ارسال نکنید، حتما باید پارامترهای ابعاد را با مقادیر مجاز ارسال کنید.

6 پارامتر parcelTypeId چیست؟

این پارامتر مربوط به نسخه‌های 1 و 2 API تیپاکس است که در نسخه 3 و 4 نیازی به ارسال ان نیست

7 کاربرد آیتم‌های senderAddressAndClient و receiverAddressAndClient چیست؟

در نسخه های 3 و 4 ای پی آی تیپاکس، زمانی که جیسون ارسالی با اطلاعات مربوط به origin و destination پر شده باشد، مقادیر مرتبط با آیتم‌های senderAddressAndClient و receiverAddressAndClient بطور خودکار پر خواهند شد، در نتیجه نیازی به ارسال این آیتم‌ها حین ثبت سفارش نیست.

8 بارکد در محیط تست دریافت شده اما در سیستم ثبت نشده؟ مشکل چیست؟

نسخه v4 به‌صورت event پیاده‌سازی شده و سفارشات بر روی صف (queue) قرار می‌گیره، بنابراین حتما باید success call back url و fail call back url در Request ارسالی وجود داشته باشد.

9 وب‌هوک (Webhook) چیست و چه تفاوتی بین نسخه‌های 3 و 4 API ای‌تی‌پاکس در استفاده از آن وجود دارد؟

وب‌هوک (Webhook) یک مکانیزم ارتباطی کارآمد بین اپلیکیشن‌ها است که امکان تبادل خودکار و آنی اطلاعات را فراهم می‌کند.

برخلاف روش سنتی «پولینگ» (Polling) که در آن یک اپلیکیشن باید به‌طور مداوم سرویس دیگر را برای دریافت اطلاعات جدید بررسی کند، وب‌هوک به سرویس مبدأ اجازه می‌دهد تا در لحظه وقوع یک رویداد (مانند تغییر وضعیت بسته پستی)، اطلاعات مربوطه را به‌صورت «پوش» (Push) به یک URL از پیش تعیین‌شده در اپلیکیشن مقصد ارسال کند. این امر باعث افزایش سرعت، کاهش سربار پردازشی و به‌روزرسانی آنی اطلاعات می‌شود.

تفاوت اصلی بین نسخه ۳ و ۴ API ای‌تی‌پاکس

تفاوت اصلی بین نسخه ۳ و ۴ API ای‌تی‌پاکس در همین نحوه تبادل اطلاعات نهفته است:

  1. نسخه ۳ (API v3): این نسخه به‌صورت «همزمان» (Synchronous) عمل می‌کند. بدین معنی که تمامی عملیات مربوط به هر سفارش (ثبت، پردازش و غیره) به‌صورت لحظه‌ای انجام شده و نتیجه بلافاصله برگردانده می‌شود. اگرچه در صورت داشتن توکن معتبر، ثبت سفارش دچار مشکل نمی‌شود، اما ماهیت همزمان این نسخه باعث تجمع بار پردازشی در صورت افزایش درخواست‌های همزمان می‌گردد.
  2. نسخه ۴ (API v4): این نسخه به‌صورت «مبتنی بر رویداد» (Event-Driven) و با استفاده از «صف‌گذاری» (Queue) پیاده‌سازی شده است. در این نسخه، ارائه URL برای «کال‌بک موفقیت» (Success Callback URL) و «کال‌بک شکست» (Fail Callback URL) الزامی است. این URLها همان اندپوینت‌های وب‌هوک هستند که ای‌تی‌پاکس تغییرات وضعیت بسته‌ها را به آن‌ها ارسال می‌کند. این معماری برای مشتریانی که قابلیت پیاده‌سازی وب‌هوک را دارند و به عملکرد بالا و مکانیزم‌های «تلاش مجدد» (Retry) نیاز دارند، ایده‌آل است.

چرا استفاده از وب‌هوک در نسخه ۴ API ای‌تی‌پاکس ضروری است؟

نسخه ۴ ای‌تی‌پاکس به‌گونه‌ای طراحی شده است که با الگوی ترافیک لحظه‌ای و پرترافیک (مثلاً ۱۰۰۰ درخواست در لحظه) سازگار باشد. وب‌هوک امکان پردازش آنی و کارآمد این حجم از درخواست‌ها را فراهم می‌کند.

شما با آماده‌سازی یک URL در سیستم خودتان که قادر به دریافت درخواست‌های HTTP POST از ای‌تی‌پاکس باشد و ثبت آن در تنظیمات، می‌توانید تغییرات وضعیت بسته‌ها را به محض وقوع دریافت و در سیستم خود به‌روزرسانی کنید. این رویکرد ضمن افزایش سرعت دریافت اطلاعات، بار پردازشی را روی سرورهای شما و ای‌تی‌پاکس کاهش می‌دهد و از به‌روز بودن دائمی اطلاعات اطمینان حاصل می‌کند.

10 هنگام فراخوانی سرویس https://omapi.tipax.ir/api/OM/v3/Tracking/ByTrackingCode گاهی خطای زیر دریافت می‌شود: API calls quota exceeded! maximum admitted 10 per 1s. دلیل این خطا چیست و چگونه می‌توان از بروز آن جلوگیری کرد؟

این خطا مربوط به محدودیت نرخ درخواست (Rate Limit) در سرویس OmOrder تیپاکس است. بر اساس تنظیمات سرور، حداکثر ۱۰ درخواست در هر ثانیه برای هر کلاینت (بر اساس API Key یا IP) مجاز است.

در صورتی که تعداد فراخوانی‌ها از این حد بیشتر شود، سامانه به‌صورت موقت مانع پردازش می‌شود و پیام خطای فوق (معمولاً همراه با وضعیت HTTP 429) برگردانده می‌شود.

روش‌های پیشنهادی برای جلوگیری از خطا

  1. بین هر batch از درخواست‌ها وقفه‌ای حدود ۱۰۰ تا ۱۵۰ میلی‌ثانیه در نظر بگیرید.
  2. در صورت امکان، چند مرسوله را به‌صورت گروهی (Bulk) داخل یک درخواست واحد ارسال کنید تا حجم فراخوانی‌ها کاهش یابد.
11 چه مقادیری برای serviceId باعث تعیین قرارداد از نوع اکسپرس می‌شوند؟

اگر برای پارامتر serviceId مقادیر زیر ارسال شود، نوع قرارداد نهایی اکسپرس خواهد بود:

  • ۱ – ارسال زمینی همان روز
  • ۲ – ارسال زمینی یک روزه
  • ۳ – ارسال زمینی دو روزه
  • ۴ – ارسال زمینی سه روزه
  • ۵ – اکسپرس ویژه بین‌شهری
  • ۷ – اکسپرس درون‌شهری

در این صورت، نوع قرارداد نهایی اکسپرس در نظر گرفته می‌شود.

12 پارامتر ‌paymentType در ثبت سفارش تیپاکس چه مقادیری را می‌پذیرد و هر مقدار چه نوع پرداختی را مشخص می‌کند؟

برای پارامتر paymentType مقادیر زیر مجاز هستند:

  • ۱۰ – سمت فرستنده / اعتباری
  • ۲۰ – سمت گیرنده / پس‌کرایه
  • ۳۰ – سمت گیرنده / پرداخت در محل
  • ۴۰ – سمت فرستنده / پرداخت در محل
  • ۵۰ – سمت فرستنده / پرداخت از کیف پول
  • ۸۰ – سمت فرستنده / نقدی

مقادیر ۱۰ و ۴۰ – کسر از اعتبار فرستنده

در صورت ارسال مقادیر ۱۰ و ۴۰، هزینه خدمات از اعتبار فرستنده (صاحب حساب کاربری در ای‌تیپاکس) در هر دو حالت کسر خواهد شد. اما در حالت سمت فرستنده – پرداخت در محل (۴۰)، سیستم به‌صورت اتوماتیک ارزش مرسوله را به‌جای COD جای‌گذاری می‌کند، در صورتی که پارامتر COD ارسال نشود یا مقدار آن کمتر از ارزش مرسوله نباشد.

مقادیر ۲۰ و ۳۰ – دریافت از گیرنده

همچنین در صورت ارسال مقادیر ۲۰ (سمت گیرنده – پس‌کرایه) و ۳۰ (سمت گیرنده – پرداخت در محل)، در هر دو حالت هزینه خدمات از گیرنده دریافت خواهد شد. اما در حالت سمت گیرنده – پرداخت در محل (۳۰)، سیستم به‌صورت اتوماتیک ارزش مرسوله را به‌جای COD جای‌گذاری می‌کند، در صورتی که پارامتر COD ارسال نشود یا مقدار آن کمتر از ارزش مرسوله نباشد.

مقدار ۸۰ – پرداخت نقدی به نماینده

در نهایت، در صورت ارسال پارامتر ۸۰ (سمت فرستنده – نقدی)، نماینده تیپاکس در زمان جمع‌آوری، هزینه ارسال را به‌صورت نقدی از فرستنده دریافت می‌کند. بنابراین در صورت ثبت سفارش در این حالت از پرداخت، لازم است پارامتر cashAmount مقداردهی و ارسال شود.

13 منظور از “کال‌بک موفقیت” (Success Callback URL) و “کال‌بک شکست” (Fail Callback URL) در API v4 تیپاکس چیست؟

در نسخه ۴ API تیپاکس، معماری به‌صورت «مبتنی بر رویداد» (Event‑Driven) و «غیرهمزمان» (Async) طراحی شده است. به همین دلیل، نتیجه پردازش هر سفارش بلافاصله در پاسخ Request برگردانده نمی‌شود. به‌جای آن، شما باید دو آدرس (URL) در اختیار تیپاکس قرار دهید تا نتیجه پردازش را در زمان مناسب برای شما ارسال کند:

  1. کال‌بک موفقیت (Success Callback URL): این URL آدرسی در سیستم شماست که تیپاکس پس از پردازش موفق درخواست (مثلاً ثبت موفق سفارش یا هر مرحله‌ای که در صف پردازش بدون خطا کامل شود) به آن یک درخواست HTTP POST ارسال می‌کند.
  2. کال‌بک شکست (Fail Callback URL): این URL برای زمانی است که پردازش درخواست با خطا مواجه شود. در چنین حالتی تیپاکس به‌جای پاسخ موفق، اطلاعات خطا را به Fail Callback URL ارسال می‌کند.

در نتیجه وجود این دو آدرس باعث می‌شود بتوانید بدون انتظار، درخواست‌ها را با سرعت بالا ارسال کنید، عملیات پشت‌صحنه را صف‌بندی و پردازش کنید، سیستم شما نتیجه را دقیق و آنی دریافت کند و همچنین سازوکار «Retry» و پایداری بالاتر برای شما فراهم شود.

14 اگر پارامتر packingId در جیسون ارسالی وجود نداشته باشد، چه می‌شود؟

اگر در جیسون ارسالی شما به تیپاکس، پارامتر packingid وجود نداشته باشد، سیستم به‌صورت اتومات نوع بسته شما را (نیاز به بسته بندی ندارد) در نظر خواهد گرفت

15 حداکثر تعداد ارقام مجاز برای فیلد پلاک در ثبت آدرس چقدر است؟

فیلد «پلاک» در زمان ثبت آدرس حداکثر می‌تواند شامل ۵ رقم عددی باشد. در صورت وارد کردن بیش از ۵ رقم، سیستم اجازه ثبت آدرس را نخواهد داد.

16 چگونه می‌توانم ID محصولات (کالاها) جدید را دریافت کنم؟

برای دریافت (Get) شناسه‌های محصولات جدید (Product IDs)، لطفاً endpoint زیر را فراخوانی (Call) نمایید:

URL: https://integrationapi.tipax.ir/api/OM/v3/Customers/myproducts

با فراخوانی این آدرس، لیستی از Product IDها در پاسخ دریافت خواهد شد.

17 در زمان Call کردن سرویس Pricing، مدت زمان (Response Time) بالایی وجود دارد، مشکل چیست؟

با توجه به معماری سامانه ای‌تیپاکس، پیش از Call کردن سرویس Pricing لازم است تا ابتدا یک سفارش ثبت و بارکد دریافت کنید و سپس مجدد سرویس Pricing را Call کنید و Response Time را بررسی کنید.

18 چگونه می‌توانم جزئیات کامل رهگیری (دست‌رشته‌ها) را مشاهده کنم؟

برای مشاهده تمامی دست‌رشته‌ها و جزئیات کامل وضعیت مرسوله، از متد POST استفاده کنید و درخواست را به آدرس زیر ارسال نمایید. مقدار trackingInput را با شماره قرارداد مرسوله جایگزین کرده و در Body درخواست یک آبجکت خالی ({}) ارسال کنید.

آدرس درخواست:
POST https://omapi.tipax.ir/api/v2/Tracking/GetJetTrackingDetail?trackingInput=3616202582144234437

نکته: به جای 3616202582144234437، شماره قرارداد موردنظر خود را قرار دهید.

19 آیا می‌توان اطلاعات مشتری (کلاینت) را از طریق API ویرایش کرد؟

بله، امکان ویرایش اطلاعات مشتری از طریق API فراهم شده است. برای این کار کافی است درخواست خود را به آدرس زیر ارسال کنید:

آدرس API:
https://omapi.tipax.ir/api/v2/client

نمونه JSON (پیلود) مورد نیاز:

متد: PUT

{ "fullName": "string", "mobile": "string", "nationalId": "string", "telephonNumber": "string", "id": "string" }

تمامی فیلدها به صورت رشته (string) ارسال می‌شوند و فیلد id برای شناسایی مشتری الزامی است.

20 ثبت سفارش به‌صورت همان روز (Same Day) در ای‌تیپاکس چگونه انجام می‌شود و چه شرایطی دارد؟

ثبت سفارش سرویس همان روز (Same Day) در ای‌تیپاکس دارای شرایط و محدودیت‌های زیر است:

1. محدوده ثبت سفارش: ثبت سفارش سرویس Same Day فقط برای مبدا و مقصد تهران به تهران امکان‌پذیر است.

2. وزن مرسوله: وزن بسته باید حداکثر 12 کیلوگرم باشد.

3. ابعاد بسته: حداکثر ابعاد بسته‌بندی باید 37 × 37 × 15 سانتی‌متر باشد تا مرسوله امکان قرارگیری در لاکر را داشته باشد.

4. تأیید آدرس مشتری: مشتری باید پیش از ثبت سفارش، آدرس خود را از طریق لینک مربوطه تأیید کرده باشد. پس از انتخاب شماره مشتری، در بخش آدرس‌ها می‌توانید لیست آدرس‌های پیشنهادی را مشاهده کرده و آدرس تأییدشده مشتری را انتخاب نمایید.

5. نوع بسته‌بندی: ثبت سفارش Same Day فقط برای بسته (کارتن) و پاکت امکان‌پذیر است و استفاده از اکوپک برای این سرویس امکان‌پذیر نیست.

6. نحوه عملکرد سرویس: در این نوع ثبت سفارش، مرسوله در ابتدا برای ارسال به آدرس مشتری در نظر گرفته می‌شود؛ هم‌زمان با ثبت سفارش، یک لاکر نیز برای مشتری رزرو می‌شود. در صورتی که مشتری در زمان مراجعه مأمور توزیع در آدرس حضور نداشته باشد، بسته به لاکر رزروشده منتقل شده و در آنجا قرار می‌گیرد تا مشتری بتواند برای دریافت مرسوله به لاکر مراجعه کند. هزینه رزرو لاکر تا 48 ساعت رایگان می‌باشد.

با مختومه شدن سفارش، رزرو مربوط به لاکر نیز به‌صورت خودکار مختومه خواهد شد.

خلاصه شرایط: تهران به تهران، حداکثر وزن 12 کیلوگرم، حداکثر ابعاد 37 × 37 × 15 سانتی‌متر، آدرس تأییدشده مشتری و فقط بسته یا پاکت.

نمونه جیسون‌های ثبت سفارش:

1. نمونه بادی ثبت سفارش با OmOrder:

{
"packages": [
{
"origin": {
"cityId": 1262,
"fullAddress": "آدرس فرستنده پلاک23",
"latitude": 35.69170938,
"longitude": 51.38147737,
"beneficiary": {
"fullName": "امیر",
"mobile": "09121234567",
"floor": "2",
"unit": "4",
"postalCode": "1234567891",
"description": "test",
}
},
"destination": {
"cityId": 1262,
"fullAddress": "آدرس گیرنده پلاک 444",
"latitude": 35.71557605,
"longitude": 51.33435723,
"floor": "12",
"unit": "32",
"postalCode": "8529637410",
"beneficiary": {
"fullName": "امیرعلی",
"mobile": "09331234567"
}
},
"customParcelTitle": "TEST",
"weight": 1,
"packageValue": 1000,
"length": 30,
"width": 40,
"height": 45,
"packageContentId": 9,
"packingId": 10,
"packType": 20,
"serviceId": 12,
"paymentType": 20,
"pickupType": 10,
"distributionType": 10,
"cod": 0,
"cashAmount": 0
}

]
}

ثبت نظر و پیشنهاد

نظرات، پیشنهادات و انتقادات شما در بهبود مستندات API تیپاکس بسیار ارزشمند است. لطفاً با تکمیل این فرم، تجربه خود را با ما در میان بگذارید.

📘 راهنمای جامع پلتفرم ای‌تیپاکس

🌐 وبسایت ای‌تیپاکس ⬇️نسخه آفلاین راهنمایی ای تیپاکس
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 29 دقیقه
📹 آموزش تصویری کامل کار با پلتفرم ای‌تیپاکس - از ثبت‌نام تا مدیریت مالی

مقدمه

ای‌تیپاکس، پلتفرم فروش سازمانی تیپاکس است که با هدف بهینه‌سازی و ساده‌سازی فرآیند ارسال کالا برای تمامی کسب‌وکارها طراحی شده است. با استفاده از ای‌تیپاکس دیگر نیازی به مراجعه حضوری به نمایندگی‌های تیپاکس و یا تماس تلفنی برای جمع‌آوری و ارسال بسته‌ها نیست.

⏱️ زمان مطالعه: حدود ۱۰ دقیقه 💻 پلتفرم: وب (ETipax) 🎥 ویدیو: 29 دقیقه

📋 مراحل گام‌به‌گام کار با ای‌تیپاکس

❓ سوالات متداول ای‌تیپاکس

۱ محدودیت ارزش سفارش چیست؟

ثبت سفارش به ارزش بیشتر از ۱۰۰,۰۰۰,۰۰۰ تومان نیاز به هماهنگی با اکانت منیجر دارد.

۲ (LTL) قوانین و مقررات سرویس باکس لاین

سرویس ال.تی.ال (باکس لاین)

سرویس ال.تی.ال فضایی از حامل را طبق شرایط مشخص به مشتریان اختصاص می‌دهد. هر فضای واحد معادل مساحت یک باکس لاین (۱.۲ × ۱ مترمربع) بوده و حداکثر وزن مجاز آن ۳۰۰ کیلوگرم و ارتفاع مجاز ۲ متر است.

در صورت تجاوز ابعاد یا وزن از این محدودیت‌ها، مشتری باید فضای جدیدی خریداری کند. برای هر فضای اختصاص‌یافته تنها یک مبدأ و یک مقصد قابل تعریف است. اگر مرسوله شامل چند بسته است، باید به‌صورت تجمیع‌شده و یکپارچه (در قالب باکس لاین شیرینگ‌شده، بچ یا گونی) ارسال شود.

تخلیه و بارگیری مرسوله بر عهده مشتری است و در صورت تحویل مرسوله در باکس لاین، مسئولیت بازگشت آن با گیرنده خواهد بود. همچنین، محتویات مرسوله باید مجاز و مطابق گروه‌های کالایی مورد تأیید تیپاکس بوده و جزو اقلام ممنوعه ارسالی نباشد.

محدودیت‌های سرویس باکس لاین

  • حداکثر ارزش مرسوله: ۱۰,۰۰۰,۰۰۰,۰۰۰ ریال
  • کف وزن: ۰.۱ کیلوگرم
  • سقف وزن: ۳۰۰ کیلوگرم
۳ تفاوت سرویس‌های اکسپرس، اکسپرس پلاس و همان‌روز (Same Day) تیپاکس چیست؟

تیپاکس سه نوع سرویس برای ارسال مرسولات ارائه می‌دهد تا کاربران بر اساس سرعت مورد نیاز خود انتخاب کنند:

  1. اکسپرس: بسته از نزدیک‌ترین نمایندگی جمع‌آوری شده و در مدت ۳ روز کاری به گیرنده تحویل می‌شود.
  2. اکسپرس پلاس: بسته نیز توسط نزدیک‌ترین نمایندگی جمع‌آوری شده، ولی با سرعت بالاتر، طی ۲۰ ساعت کاری تحویل داده می‌شود. برای استفاده از این سرویس باید بسته را تا ساعت ۱۷:۰۰ همان روز به نمایندگی تحویل دهید؛ در غیر این صورت ارسال آن به اولین نوبت کاری بعدی موکول خواهد شد.
  3. همان روز (Same Day): سریع‌ترین گزینه است که بسته را ظرف ۱۰ ساعت کاری به مقصد می‌رساند. کافی‌ست مرسوله تا ساعت ۱۴:۰۰ به نمایندگی تحویل داده شود تا حداکثر تا ساعت ۲۲:۰۰ همان روز به گیرنده برسد، و در صورت تحویل دیرتر از این زمان، ارسال در نخستین نوبت کاری روز آینده انجام می‌گیرد.

نکته: سرویس‌های اکسپرس پلاس و همان روز فعلاً فقط در شهرهای تهران و البرز فعال هستند و سایر شهرها می‌توانند از سرویس اکسپرس استفاده کنند.

۴ اگر سفارش در پلتفرم ای‌تی‌پاکس (eTipax) ثبت شود اما عملیات جمع‌آوری (Pickup) انجام نشود، چه اتفاقی می‌افتد؟

در این حالت، سفارش پس از گذشت ۳۰ روز (مدت زمان Expire) به‌صورت خودکار منقضی شده و ابطال می‌گردد.

۵ عوامل اصلی تاثیرگذار بر هزینه خدمات در تیپاکس چیست؟

هزینه خدمات در تیپاکس بر اساس چندین عامل کلیدی تعیین می‌گردد. این عوامل عبارتند از فاصله بین مبدا و مقصد، نوع سرویس انتخابی، نوع بسته ارسالی، ارزش اعلام‌شده برای مرسوله جهت بیمه، وزن و ابعاد فیزیکی بسته (طول، عرض و ارتفاع)، و همچنین نحوه جمع‌آوری مرسوله (حضوری یا در محل).

۶ مبلغ قرارداد (finalPrice) چگونه محاسبه می‌شود؟

مبلغ نهایی قرارداد برابر است با مجموع هزینه خدمات، هزینه بسته‌بندی، مالیات بر ارزش افزوده و هزینه جبران خسارت (پوشش ارزش کالا). این مبلغ در پاسخ API با پارامتر finalPrice بازگردانده می‌شود.

۷ محدودیت‌های وزن و ارزش مرسوله برای هر نوع بسته‌بندی چقدر است؟

در API تیپاکس، چهار نوع بسته‌بندی تعریف شده است که هر کدام دارای سقف مشخصی برای وزن و ارزش مرسوله هستند. در هنگام ثبت سفارش، رعایت این محدودیت‌ها الزامی است:

نوع بسته‌بندیمحدودیت وزنسقف ارزش مرسوله (ریال)
حجیم و سنگینحداقل ۳۰ کیلوگرم - حداکثر ۱۰۰ کیلوگرم۳,۰۰۰,۰۰۰,۰۰۰
بسته (کارتن)حداکثر ۳۰ کیلوگرم۱,۰۰۰,۰۰۰,۰۰۰
پاکتحداکثر ۲ کیلوگرم۲۰,۰۰۰,۰۰۰
مینی پک (فلایر)حداکثر ۲ کیلوگرم۱۰۰,۰۰۰,۰۰۰

توجه: در صورت ارسال مقادیر فراتر از این محدودیت‌ها، سیستم با خطای اعتبارسنجی (Validation Error) مواجه خواهد شد.

۸ مشخصات بسته بندی اکوپک چیست؟
  • بسته بندی اکو پک تخفیف ندارد.
  • جمع اوری در محل نمایندگی می باشد.
  • نوع بسته بندی فقط فلایر A4 به ابعاد 21.5*30*5 می باشد.
  • وزن مرسوله تا 1 کیلوگرم است.
  • ارزش مرسوله 15000000 ریال می باشد.
۹ لجستیک معکوس چیست و چگونه ثبت می‌شود؟

سرویس لجستیک معکوس برای جمع‌آوری و بازگرداندن مرسولات از گیرنده به فرستنده طراحی شده است. این سرویس در سامانه مشابه ثبت سفارش عادی انجام می‌شود، با این تفاوت که تمامی هزینه‌های حمل تنها توسط فرستنده پرداخت می‌شود و امکان پرداخت هزینه توسط گیرنده وجود ندارد.

فرآیند تحویل مرسوله

پس از ثبت سفارش، یک پیامک حاوی بارکد مرسوله و لینک مربوط به رهگیری سفارش برای گیرنده ارسال می‌شود. گیرنده هنگام تحویل مرسوله به نماینده تیپاکس، کافی است بارکد دریافتی را ارائه دهد.

نمونه پیامک ارسالی

مشتری محترم تیپاکس، سلام

بسته مرجوعی شما توسط [نام ثبت‌کننده] با بارکد [بارکد مرسوله] در سامانه ثبت شد. لطفاً هنگام تحویل، بارکد را ارائه دهید.

لینک: [لینک سفارش]

تیپاکس – ۰۲۱۸۴۵۷

📊 راهنمای ثبت سفارش گروهی با اکسل در ای‌تیپاکس

راهنمای آفلاین ثبت سفارش گروهی اکسل
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 13 دقیقه
📹 آموزش تصویری کامل ثبت سفارش گروهی با اکسل در ای‌تیپاکس - از دانلود تا دریافت بارکد

مقدمه

ثبت سفارش گروهی با اکسل یکی از قابلیت‌های قدرتمند پلتفرم ای‌تیپاکس است که به شما امکان می‌دهد تعداد زیادی سفارش را به صورت همزمان و با استفاده از یک فایل اکسل ثبت کنید. این روش برای کسب‌وکارهایی که روزانه حجم بالایی از سفارش‌ها را ارسال می‌کنند، بسیار کارآمد و زمان‌بر است.

⏱️ زمان مطالعه: حدود ۸ دقیقه 📊 فرمت فایل: Excel (xlsx) 🎥 ویدیو: 13 دقیقه

📋 مراحل گام‌به‌گام ثبت سفارش گروهی با اکسل در ای تیپاکس

🤖 راهنمای جامع ربات تیپاکس در پیام‌رسان بله

🤖 بازوی رسمی تیپاکس در بله ⬇️نسخه آفلاین راهنمایی ربات بله
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 5 دقیقه
📹 آموزش تصویری کامل ثبت سفارش در ربات تیپاکس - از ورود تا دریافت فاکتور

🔹 ربات تیپاکس در پیام‌رسان بله، امکان ثبت سفارش، دریافت فاکتور، رهگیری مرسوله و برآورد هزینه را به ساده‌ترین شکل ممکن فراهم کرده است.

📋 این راهنما تمام مراحل را به‌صورت گام‌به‌گام از صفر تا صد پوشش می‌دهد.

⏱️ زمان مطالعه: ۳ دقیقه | 📱 پلتفرم: پیام‌رسان بله | 🎥 ویدیو: 5 دقیقه

📋 مراحل گام‌به‌گام استفاده از ربات تیپاکس

⚠️ نکته مهم: در صورت بروز هرگونه مشکل، با تیم پشتیبانی تیپاکس تماس بگیرید.

📦 آموزش پیکربندی پلاگین ثبت سفارش تیپاکس در وردپرس

⬇️ لینک دانلود پلاگین 🌐⬇️نسخه آفلاین راهنمایی پلاگین وردپرس
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 25 دقیقه
آموزش تصویری کامل نصب و راه اندازی پلاگین ورد پرس

✅ پس از دانلود و نصب افزونه، آن را فعال کنید. پس از فعال‌سازی، گزینه «حمل با تیپاکس» در منوی سمت راست وردپرس نمایش داده می‌شود.

⚙️ تنظیمات پلاگین شامل ۱۰ تب است که در ادامه هر بخش توضیح داده شده است.

📋 تب‌های تنظیمات پلاگین تیپاکس

۱

🔗 تب «اتصال»

وارد کردن اطلاعات حساب ای‌تیپاکس

در این بخش اطلاعات حساب ای‌تیپاکس را وارد کنید.

اطلاعات مورد نیاز:

  • نام کاربری
  • رمز عبور
  • API Key

پس از وارد کردن اطلاعات، روی دکمه «ذخیره تنظیمات» کلیک کنید.

۲

🧪 تب «بررسی اتصال»

بررسی صحت ارتباط پلاگین با ای‌تیپاکس

در این بخش می‌توانید بررسی کنید که آیا پلاگین به‌صورت کامل با ای‌تیپاکس ارتباط برقرار کرده است یا خیر.

در صورت وجود مشکل در اتصال، پیام خطا نمایش داده می‌شود.

۳

📍 تب «آدرس‌ها»

مدیریت آدرس‌ها و انتخاب آدرس مبدأ

در این بخش، آدرس‌هایی که قبلاً در ای‌تیپاکس ثبت کرده‌اید نمایش داده می‌شوند. همچنین امکان اضافه کردن آدرس جدید نیز وجود دارد.

⚠️ نکته مهم: حتماً یکی از آدرس‌ها را در این بخش به‌عنوان آدرس مبدأ انتخاب کنید تا پلاگین بتواند آدرس مبدأ را به‌صورت صحیح فراخوانی کند.
۴

🏙️ تب «شهرها»

مدیریت شهرهای تحت پوشش حمل‌ونقل

در این بخش لیست شهرهایی که حمل‌ونقل تیپاکس را پشتیبانی می‌کنند قابل مشاهده است.

همچنین در صورت نیاز می‌توانید سرویس حمل‌ونقل تیپاکس را برای شهرهای موردنظر فعال یا غیرفعال کنید.

۵

📋 تب «سفارشات»

مدیریت سفارش‌های ثبت‌شده با تیپاکس

در این بخش، سفارش‌هایی که با روش حمل‌ونقل تیپاکس ثبت شده‌اند قابل مشاهده هستند. در این بخش امکان انجام موارد زیر وجود دارد:

  • مشاهده سفارش‌ها
  • پرینت گروهی
  • بروزرسانی وضعیت سفارش
  • انجام عملیات به‌صورت جداگانه برای هر سفارش

ثبت مجدد سفارش در تیپاکس: اگر سفارشی با خطا مواجه شده باشد یا بخواهید سفارش را به‌صورت آفلاین مجدداً ثبت کنید، می‌توانید از گزینه «ثبت مجدد در تیپاکس» استفاده کنید.

پس از انتخاب این گزینه، یک پنجره باز می‌شود که امکان ویرایش موارد زیر را فراهم می‌کند:

  • آدرس مبدأ
  • نوع بسته‌بندی
  • وزن بسته

پس از اصلاح اطلاعات می‌توانید سفارش را مجدداً ارسال کرده و بارکد دریافت کنید.

۶

👛 تب «کیف پول»

مشاهده موجودی و شارژ کیف پول

در این بخش موجودی کیف پول قابل مشاهده است.

همچنین امکان شارژ کیف پول از همین بخش وجود دارد.

۷

⚙️ تب «تنظیمات»

پیکربندی اصلی عملکرد پلاگین

تب تنظیمات یکی از بخش‌های اصلی پیکربندی پلاگین تیپاکس است. در این بخش می‌توانید تنظیمات مختلف مربوط به نحوه عملکرد پلاگین را انجام دهید.

تنظیمات چاپ: در این قسمت امکان تنظیم موارد زیر وجود دارد:

  • لوگوی چاپ فاکتور
  • نوع لیبل

مدل پرداخت: می‌توانید مدل پرداخت را انتخاب کنید، از جمله: پس‌کرایه و نقدی. همچنین می‌توانید مبلغی را که قرار است مشتری پرداخت کند، مشخص کنید.

نمایش مبلغ پس‌کرایه: اگر نمی‌خواهید مبلغ پس‌کرایه در صفحه تسویه‌حساب به کاربر نمایش داده شود، می‌توانید گزینه «نمایش مبلغ دریافتی از تیپاکس» را غیرفعال کنید. با غیرفعال کردن این گزینه، مبلغ پس‌کرایه در عنوان روش ارسال نمایش داده نمی‌شود.

وزن، ابعاد و نوع بسته‌بندی پیش‌فرض: در این قسمت می‌توانید برای کاربران وزن پیش‌فرض، ابعاد پیش‌فرض و نوع بسته‌بندی تیپاکس را انتخاب کنید.

رهگیری مرسوله: در پایین صفحه تنظیمات، شورت‌کد زیر قرار دارد: [tipax_tracking]

📌 با قرار دادن این شورت‌کد در هر صفحه از سایت، می‌توانید بخش رهگیری تیپاکس را در آن صفحه نمایش دهید.
۸

💰 تب «گزارش مالی»

مشاهده تراکنش‌های مالی اخیر

در این بخش می‌توانید ۱۰۰ تراکنش مالی اخیر خود را مشاهده کنید.

۹

🎧 تب «پشتیبانی»

ارتباط با پشتیبانی از طریق تیکت

در این بخش می‌توانید از طریق تیکت با قسمت پشتیبانی در ارتباط باشید.

۱۰

📊 تب «لاگ»

بررسی رویدادها و خطاهای سیستم

در این بخش اطلاعات مربوط به عملکرد و خطاهای سیستم ثبت می‌شود.

در صورتی که سیستم با اختلال مواجه شود، بررسی لاگ‌ها می‌تواند به شناسایی و رفع مشکل کمک کند.

⚠️ نکته مهم: در صورت بروز هرگونه مشکل، بخش «لاگ» (Logs) افزونه را بررسی کنید.

📱 راهنمای ثبت سفارش در سامانه مای‌تیپاکس

دانلود از گوگل پلی (اندروید)⬇️ نسخه وب اپلیکیشن (ios)⬇️ دانلود از بازار ⬇️ راهنمای آفلاین مای‌تیپاکس 🌐 ورود به سامانه مای‌تیپاکس 📋 قوانین و مقررات 🎁 باشگاه مشتریان
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 9 دقیقه
📹 آموزش تصویری کامل کار با اپلیکیشن مای تیپاکس - از ثبت‌نام تا رهگیری مرسوله

مقدمه

اپلیکیشن مای تیپاکس (My Tipax) راه‌حلی سریع و آسان برای ثبت، پیگیری و مدیریت سفارش‌های پستی است. با استفاده از این اپلیکیشن می‌توانید بدون نیاز به مراجعه حضوری، مرسوله‌های خود را ثبت کرده و وضعیت آن‌ها را در لحظه پیگیری کنید.

⏱️ زمان مطالعه: حدود ۸ دقیقه 📱 پلتفرم: اندروید و iOS 🎥 ویدیو: 9 دقیقه

📋 مراحل گام‌به‌گام استفاده از اپلیکیشن مای تیپاکس

❓ سوالات متداول مای‌تیپاکس

۱ جمع‌آوری بسته‌ها در چه زمانی انجام می‌شود؟

جمع‌آوری در روزهای شنبه تا چهارشنبه در سه بازه ۹ تا ۱۲، ۱۲ تا ۱۵، ۱۵ تا ۱۸ و در روزهای پنجشنبه در دو بازه ۹ تا ۱۲ و ۱۲ تا ۱۵ جمع‌آوری انجام می‌شود.

۲ آیا امکان بسته‌بندی در آدرس فرستنده وجود دارد؟

بله، در صورت درخواست مشتری، بسته‌بندی پس از جمع‌آوری بسته توسط تیپاکس‌یار انجام خواهد شد.

۳ چگونه می‌توانم سفارشم را پیگیری کنم؟

پس از ثبت سفارش، کد رهگیری به شماره موبایلی که سفارش با آن ثبت شده است، پیامک خواهد شد. با استفاده از این کد، می‌توانید در بخش «رهگیری» مای‌تیپاکس از وضعیت بسته خود مطلع شوید.

۴ چطور می‌توانم با پشتیبانی مای‌تیپاکس تماس بگیرم؟

می‌توانید از بخش پشتیبانی مای‌تیپاکس درخواست خود را ثبت کنید یا با واحد صدای مشتری به شماره ۰۲۱-۸۴۵۷ تماس بگیرید.

۵ بسته من آسیب دیده، چطور خسارت من جبران می‌شود؟

گیرنده باید در هنگام تحویل بسته، در صورت مشاهده آسیب‌دیدگی در ظاهر بسته، این موضوع را اعلام کند. پس از آسیب‌دیدگی، مفقودی یا کم‌شدن محتویات داخل بسته، شکایت خود را از طریق درخواست پشتیبانی مای‌تیپاکس یا تماس با شماره ۸۴۵۷-۰۲۱ اعلام کنید.

۶ آیا امکان استرداد وجه در مای‌تیپاکس وجود دارد؟

بله، در صورتی‌که جمع‌آوری مای‌تیپاکس انجام نشده یا سفارش از سوی فرستنده لغو شده باشد، مشتری می‌تواند از قسمت کیف پول مای‌تیپاکس درخواست بازگشت وجه را ثبت کند.

۷ بیشترین وزن و ابعاد بسته هنگام ثبت سفارش در مای‌تیپاکس چقدر است؟

بیشترین وزن قابل ثبت در اپلیکیشن مای‌تیپاکس ۶ کیلوگرم است و یکی از ابعاد حداکثر می‌تواند ۴۵ سانتی‌متر باشد.

۸ جبران خسارت برای بسته‌هایی که در مای‌تیپاکس ثبت می‌شوند چه شرایطی دارد؟

حداقل جبران خسارت برای سفارشاتی که در اپلیکیشن مای‌تیپاکس ثبت می‌شوند ۴۰۰ هزار تومان و حداکثر آن ۵ میلیون تومان است.

📦 راهنمای ثبت سفارش باکس‌لاین در ای‌تیپاکس

🌐 وبسایت ای‌تیپاکس ⬇️ نسخه آفلاین راهنمایی باکس لاین
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 6 دقیقه
📹 آموزش تصویری کامل ثبت سفارش باکس‌لاین در ای‌تیپاکس

مقدمه

باکس‌لاین یکی از سرویس‌های تیپاکس است که فضایی اختصاصی از حامل را طبق شرایط مشخص به مشتریان اختصاص می‌دهد. این سرویس برای کسب‌وکارهایی که نیاز به ارسال حجم بالایی از مرسولات به‌صورت تجمیع‌شده دارند، ایده‌آل است.

برای ثبت سفارش «باکس‌لاین» در ای‌تیپاکس، از منوی «سفارش» گزینه «ثبت سفارش باکس‌لاین» را انتخاب کنید؛ پس از انتخاب این گزینه، صفحه ثبت سفارش نمایش داده می‌شود. در این راهنما، هر سه مرحله ثبت سفارش به‌همراه نحوه مشاهده و مدیریت سفارش‌های باکس‌لاین، به‌صورت گام‌به‌گام توضیح داده شده است.

⏱️ زمان مطالعه: حدود ۵ دقیقه 💻 پلتفرم: ای‌تیپاکس (وب) 📦 سرویس: باکس‌لاین

📋 مراحل گام‌به‌گام ثبت سفارش باکس‌لاین

1

مرحله اول | اطلاعات ثبت سفارش

مرحله 1 از 4

برای ثبت سفارش «باکس‌لاین» در ای‌تیپاکس، از منوی «سفارش» گزینه «ثبت سفارش باکس‌لاین» را انتخاب کنید. پس از انتخاب این گزینه، صفحه ثبت سفارش نمایش داده می‌شود.

ابتدا باید اطلاعات موردنیاز پنج بخش را تکمیل کنید:

  • نام فرستنده
  • آدرس فرستنده
  • نام گیرنده
  • آدرس گیرنده
  • افزودن پالت

بخش اول | نام فرستنده

نام فرستنده را از لیست انتخاب کنید.

بخش دوم | آدرس فرستنده

آدرس فرستنده را از لیست آدرس‌ها انتخاب کنید.

  • آدرس انتخاب‌شده باید دارای ساعت شروع به کار و ساعت پایان کار باشد.
  • در صورت نبود این اطلاعات، پیام «آدرس باید دارای زمان شروع و پایان باشد» نمایش داده می‌شود.
  • در صورت نبود اطلاعات زمانی، می‌توانید آدرس جدیدی ایجاد کرده یا آدرس فعلی را ویرایش کنید.

هنگام تعیین ساعت، روی آیکون ساعت در قسمت ساعت شروع به کار و ساعت پایان کار کلیک کرده و زمان موردنظر را انتخاب کنید.

بخش سوم | نام گیرنده

نام گیرنده را از لیست انتخاب کنید.

بخش چهارم | آدرس گیرنده

آدرس گیرنده را از لیست آدرس‌ها انتخاب کنید.

  • آدرس گیرنده نیز باید دارای ساعت شروع و ساعت پایان باشد.
  • در صورت نبود این اطلاعات، پیام «آدرس باید دارای زمان شروع و پایان باشد» نمایش داده می‌شود.
  • در صورت نبود اطلاعات زمانی، می‌توانید آدرس جدیدی ایجاد کرده یا آدرس فعلی را ویرایش کنید.

هنگام تعیین ساعت، روی آیکون ساعت در قسمت ساعت شروع به کار و ساعت پایان کار کلیک کرده و زمان موردنظر را انتخاب کنید.

بخش پنجم | افزودن پالت

اطلاعات مربوط به پالت را وارد کنید. در یک سفارش امکان ثبت چند پالت وجود دارد.

هر پالت دارای محدودیت وزن و ارزش است:

ویژگیمقدار مجاز
وزن مجاز۰.۱ تا ۳۰۰ کیلوگرم
ارزش مجاز۱ ریال تا ۱۰ میلیارد ریال
نکته مهم: آدرس فرستنده و گیرنده حتماً باید دارای ساعت شروع و پایان کار باشند.
2

مرحله دوم | نحوه پرداخت و ارسال

مرحله 2 از 4

در این مرحله، اطلاعات مربوط به جمع‌آوری سفارش و هزینه ارسال را مشخص کنید.

زمان جمع‌آوری

قسمت زمان جمع‌آوری شامل دو فیلد است:

  • تاریخ شروع
  • تعداد روز مهلت

تاریخ شروع: تاریخ شروع جمع‌آوری می‌تواند از روز جاری تا حداکثر ۳۰ روز آینده تعیین شود.

تعداد روز مهلت: تعداد روز مهلت، بازه زمانی تعیین‌شده برای مراجعه تیپاکس جهت جمع‌آوری سفارش است. این مقدار باید حداقل ۱ روز و حداکثر ۳۰ روز باشد.

هزینه ارسال

هزینه ارسال سفارش باکس‌لاین به دو روش قابل پرداخت است:

  • پرداخت اعتباری
  • پرداخت از کیف پول
نکته مهم: جهت پرداخت از کیف پول، خواهشمند است پیش از انتخاب روش پرداخت، کیف پول خود را شارژ فرمایید.
3

مرحله سوم | بازبینی و تأیید

مرحله 3 از 4

در این مرحله، تمامی اطلاعات سفارش نمایش داده می‌شود. اطلاعات را به‌دقت بررسی کرده و در صورت صحت، روی گزینه «ارسال سفارش» کلیک کنید.

وضعیت سفارش پس از ثبت

پس از ثبت، سفارش ابتدا به‌صورت پیش‌سفارش ثبت می‌شود. در این مرحله:

  • سفارش فاقد شماره قرارداد است.
  • امکان رهگیری سفارش وجود ندارد.
  • سفارش باید توسط ادمین بررسی و تأیید شود.

پس از تأیید ادمین، سفارش از وضعیت پیش‌سفارش خارج شده و شماره قرارداد برای آن صادر می‌شود. پس از صدور شماره قرارداد، امکان رهگیری سفارش فراهم خواهد شد.

کسر هزینه ارسال

  • هنگام ثبت پیش‌سفارش، مبلغ سفارش در حساب شما به‌صورت موقت رزرو (فریز) می‌شود.
  • هزینه ارسال پس از تأیید سفارش توسط ادمین، از اعتبار یا مانده حساب شما کسر خواهد شد.
نکته مهم: ثبت پیش‌سفارش به معنی کسر هزینه نیست؛ بلکه مبلغ به‌صورت موقت در حساب شما رزرو می‌شود و پس از تأیید سفارش توسط ادمین کسر می‌گردد.
4

مشاهده و مدیریت سفارش‌های باکس‌لاین

مرحله 4 از 4

لیست سفارش‌های باکس‌لاین

برای مشاهده و مدیریت سفارش‌های ثبت‌شده، از منوی «سفارش» وارد بخش «لیست سفارشات باکس‌لاین» شوید. در این بخش اطلاعات سفارش‌های ثبت‌شده قابل مشاهده است.

اقدامات قابل انجام پیش از تأیید

  • از ستون وضعیت سفارش می‌توانید نسبت به لغو سفارش اقدام کنید.
  • با کلیک روی آیکون مداد می‌توانید اطلاعات سفارش را ویرایش کنید.
نکته مهم: امکان لغو یا ویرایش سفارش، پیش از تأیید سفارش توسط ادمین وجود دارد.

🔐 راهنمای جامع لاکر تیپاکس

🌐 وبسایت ای‌تیپاکس ⬇️ نسخه آفلاین راهنمایی لاکر
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 8 دقیقه
📹 آموزش تصویری کامل سرویس لاکر تیپاکس

مقدمه

لاکر هوشمند جابار یک صندوق پستی الکترونیکی و خودکار است که در مکان‌های پرتردد مانند مراکز خرید، مجتمع‌های تجاری و ساختمان‌های اداری مستقر می‌شود و وظیفه نگهداری ایمن مرسولات پستی و سفارش‌های فروشگاه‌های اینترنتی را بر عهده دارد. این سرویس به گیرنده امکان می‌دهد بدون نیاز به حضور در آدرس مشخص یا انتظار برای مامور پست، بسته خود را در نزدیک‌ترین ایستگاه لاکر و در زمانی که خودش تعیین می‌کند دریافت کند. فرایند کار به این صورت است که پس از قرارگیری بسته در محفظه لاکر، کد اختصاصی برداشت برای گیرنده پیامک می‌شود و او می‌تواند در بازه زمانی مشخص، با وارد کردن این کد بسته را تحویل بگیرد. استفاده از لاکر جابار اختیاری است و هزینه اضافی ندارد؛ همچنین در صورت انتخاب لاکر به‌عنوان مقصد از همان ابتدای ثبت سفارش، هزینه توزیع از هزینه ارسال کسر می‌شود.

جابار نزدیک به خودتان را پیدا کنید

اطلاعات ایستگاه‌های جابار در تهران

⏱️ زمان مطالعه: حدود ۵ دقیقه 🔐 پلتفرم: لاکر 🎥 ویدیو: 8 دقیقه

📋 آموزش ثبت سفارش به مقصد لاکر

✅ پیش‌نیاز: داشتن حساب کاربری فعال در سامانه ای‌تیپاکس به نشانی https://etipaxco.com/
1

ورود به سامانه

مرحله 1 از 5

به نشانی etipaxco.com وارد شوید و با حساب کاربری خود وارد سامانه ای‌تیپاکس شوید.

2

شروع ثبت سفارش

مرحله 2 از 5

از منوی سفارش، گزینه «ارسال به مقصد لاکر» را انتخاب کنید.

3

تکمیل اطلاعات

مرحله 3 از 5

اطلاعات فرستنده، مرسوله و گیرنده را مانند ثبت سفارش معمولی تکمیل کنید. فرایند ثبت سفارش با سفارش‌های عادی تفاوتی ندارد.

4

انتخاب لاکر

مرحله 4 از 5

پس از تکمیل اطلاعات گیرنده، دکمه آبی «انتخاب لاکر» در کادر آدرس گیرنده ظاهر می‌شود. با کلیک روی آن، لاکرهای فعال روی نقشه نمایش داده می‌شوند یا می‌توانید لیست لاکرها را ببینید و لاکر مورد نظر خود را انتخاب کنید.

5

رزرو لاکر

مرحله 5 از 5

با کلیک روی هر لاکر، رزرو انجام می‌شود و اطلاعات زیر به شما نمایش داده می‌شود:

  • شماره سفارش
  • شماره ثبت
  • تاریخ شروع
  • تاریخ پایان
  • هزینه استفاده از لاکر
  • مالیات
  • هزینه نهایی
نکات مهم:
  • ابعاد مجاز بسته برای قرار گرفتن در لاکر حداکثر ۳۱ در ۳۶ در ۳۸ سانتی‌متر است.
  • امکان برداشت بسته از لاکر تا ۴۸ ساعت پس از قرارگیری وجود دارد.
  • استفاده از لاکر هزینه اضافی ندارد و در صورت انتخاب لاکر به عنوان مقصد از ابتدا، هزینه توزیع از هزینه ارسال کسر می‌شود.
  • انتخاب لاکر اختیاری است.
  • پس از قرارگیری بسته در لاکر، کد اختصاصی برداشت برای گیرنده پیامک می‌شود و گیرنده با این کد بسته را دریافت می‌کند.
  • تمامی خدمات تکمیلی مانند جبران خسارت، پس‌کرایه، COD و رهگیری آنلاین در این سرویس قابل استفاده است.

⚡ آموزش ثبت سفارش سرویس «همان روز» در پنل تیپاکس

🌐 وبسایت ای‌تیپاکس ⬇️ نسخه آفلاین راهنمایی same day
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 6:47
📹 آموزش تصویری کامل سرویس Same Day تیپاکس

مقدمه

سرویس «همان روز» یکی از خدمات ارسال مرسولات در پنل تیپاکس است که امکان تحویل بسته در همان روز ثبت سفارش را فراهم می‌کند. در این راهنما، مراحل ثبت سفارش به‌صورت گام‌به‌گام توضیح داده می‌شود.

نکته مهم: سرویس «همان روز» صرفاً در محدوده شهر تهران فعال است؛ یعنی ارسال از تهران به تهران امکان‌پذیر می‌باشد.
⏱️ زمان مطالعه: حدود ۵ دقیقه ⚡ پلتفرم: Same Day 🎥 ویدیو: به‌زودی

📋 مراحل گام‌به‌گام ثبت سفارش Same Day

1

ورود به بخش ثبت سفارش

مرحله 1 از 6
  1. وارد پنل تیپاکس شوید.
  2. از منوی اصلی، گزینه «سفارش» و سپس «ثبت سفارش» را انتخاب کنید.
2

مشخص کردن اطلاعات فرستنده

مرحله 2 از 6
  1. اطلاعات فرستنده را تعیین کنید.
  2. آدرس فرستنده را به یکی از روش‌های زیر مشخص نمایید:
    • انتخاب آدرس از میان آدرس‌های ذخیره‌شده قبلی؛
    • یا کلیک روی گزینه «ویرایش» و ثبت آدرس جدید.
آدرس فرد فرستنده باید نزدیک یکی از نمایندگی‌های معین ما باشد.
3

افزودن بسته

مرحله 3 از 6
  1. روی دکمه «افزودن بسته» کلیک کنید.
  2. اطلاعات بسته شامل ابعاد و وزن را وارد کنید.

چرا ابعاد و وزن بسته اهمیت دارد؟

هنگام ثبت سفارش «همان روز»، یک لاکر (کمد تحویل هوشمند) به‌صورت خودکار برای مرسوله رزرو می‌شود. در صورتی که گیرنده در منزل حاضر نباشد یا امکان تحویل‌گیری را نداشته باشد، مرسوله به همان لاکر منتقل می‌شود و تا زمان مراجعه گیرنده در آن باقی می‌ماند. بنابراین:

  • ابعاد بسته باید به‌گونه‌ای باشد که داخل لاکر قرار گیرد؛
  • وزن بسته نیز باید متناسب با ظرفیت لاکر باشد.

محدودیت‌های ابعاد و وزن بسته

ویژگیمقدار مجاز
طول و عرضحداکثر ۳۷ × ۳۷ سانتی‌متر
ارتفاعحداکثر ۱۵ سانتی‌متر
وزنحداکثر ۱۲ کیلوگرم
توضیح: در این آموزش، مرسوله‌ای با ابعاد ۱۰ سانتی‌متر انتخاب شده که مطابق با محدودیت‌های ذکرشده است. محتویات بسته جنبه عمومی داشته و وزنی کمتر از یک کیلوگرم دارد.
4

مشخص کردن اطلاعات گیرنده

مرحله 4 از 6
  1. نام گیرنده را وارد کنید.
  2. آدرس گیرنده را مشخص نمایید.
5

انتخاب سرویس «همان روز»

مرحله 5 از 6
  1. روی دکمه «مرحله بعد» کلیک کنید.
  2. گزینه «سرویس همان روز» را انتخاب نمایید. در این بخش توضیحاتی درباره سرویس نمایش داده می‌شود.
نکات مهم این مرحله:
  • تحویل بسته به تیپاکس: بسته باید حداکثر تا ساعت ۱۳:۰۰ به تیپاکس تحویل داده شود.
  • بسته‌بندی: امکان انتخاب بسته «اکوپک» وجود ندارد؛ زیرا اکوپک خود یک نوع بسته‌بندی اقتصادی است و با شرایط این سرویس سازگار نیست.
6

بازبینی و ارسال سفارش

مرحله 6 از 6
  1. روی دکمه «مرحله بعد» کلیک کنید.
  2. در این مرحله تمامی اطلاعات سفارش به‌صورت خلاصه نمایش داده می‌شود، از جمله:
    • اطلاعات کامل بسته
    • اطلاعات فرستنده و گیرنده
    • اطلاعات لاکر رزروشده
  3. پس از بازبینی و اطمینان از صحت اطلاعات، روی دکمه «ارسال سفارش» کلیک کنید.
با انجام مراحل فوق، سفارش سرویس «همان روز» با موفقیت در پنل تیپاکس ثبت می‌شود و مرسوله در همان روز ارسال خواهد شد.

🏭 آموزش ثبت سفارش فولفیلمنت تیپاکس

🌐 وبسایت ای‌تیپاکس ⬇️ نسخه آفلاین راهنمایی فولفیلمنت
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 13:00
📹 آموزش تصویری کامل خدمات فولفیلمنت تیپاکس

مقدمه

سرویس فولفیلمنت شامل انبارداری، بسته‌بندی، و ارسال مرسولات است. تیپاکس تمام مراحل از دریافت کالا تا تحویل به مشتری نهایی را مدیریت می‌کند. برای اطلاعات بیشتر و راهنمایی کامل، می‌توانید متن این راهنما را مطالعه بفرمایید و ویدئوی آموزشی را مشاهده بفرمایید.

پیش‌نیاز: قبل از شروع مراحل ثبت سفارش، دسترسی مشتری مد نظر به نمایندگی مربوطه در پنل IGT (مدیریت کاربران) باید توسط ادمین سیستم ایجاد شود.
⏱️ زمان مطالعه: حدود ۱۰ دقیقه 🏭 پلتفرم: فولفیلمنت 🎥 ویدیو: به‌زودی

📋 مراحل گام‌به‌گام ثبت سفارش فولفیلمنت

1

ورود به سایت ای‌تیپاکس

مرحله 1 از 3

در مرحلهٔ اول، مشتری در سایت ای‌تیپاکس با حساب کاربری خود وارد می‌شود.

ایجاد حساب کاربری ای‌تیپاکس

  • استفاده از ایمیل معتبر: هنگام ایجاد حساب کاربری در ای‌تیپاکس، حتماً از یک ایمیل معتبر استفاده کنید تا در صورت فراموشی رمز عبور، بتوانید از طریق آن اقدام به بازیابی رمز عبور حساب خود کنید.
  • ثبت اطلاعات حساب بانکی: پس از ثبت‌نام در ای‌تیپاکس، برای جلوگیری از بروز مشکلات مربوط به پرداختی‌های تیپاکس، حساب بانکی خود را ثبت کنید.

تعریف کالا در انبار

در داشبورد پنل ای‌تیپاکس، مسیر زیر را دنبال کنید:

تب کالا ← کالا در انبار

در قسمت «کالا در انبار» دو تب مشاهده می‌شود:

  • موجودی انبار من: جهت تعریف کالا، در نمایندگی مرتبط، بالا سمت چپ مودال «ایجاد نوع کالا در انبار» را کلیک کنید و اطلاعات مورد نظر کالا به تعداد مشخص در نمایندگی مشخص را وارد کنید و منتظر تایید نمایندگی مرتبط بمانید.
  • درخواست‌های من: وضعیت درخواست‌های پذیرفته شده یا در انتظار تایید، موجودی انبار و کسری کالا طبق درخواست‌ها را نمایش می‌دهد.
2

ورود نمایندگی به پنل IGT

مرحله 2 از 3

در این مرحله، نمایندگی مرتبط که دسترسی فولفیلمنت را دارد، از طریق پنل IGT وارد پنل خود می‌شود.

مسیر: مدیریت مشتریان ← مشتریان من ← انبار

در این بخش، نمایندگی درخواست‌های ثبت شده از سمت مشتری را مشاهده می‌کند و می‌تواند:

  • تایید کند — قرار گرفتن تعداد مشخص کالای مشتری در انبار و سپس ارسال از انبار نمایندگی.
  • رد کند — در صورت عدم امکان پذیرش کالا.
پس از تایید نمایندگی، کالای مشتری در انبار نمایندگی ثبت می‌شود و مشتری می‌تواند برای ثبت سفارش اقدام کند.
3

ثبت سفارش توسط مشتری

مرحله 3 از 3

در این مرحله، بعد از تایید نمایندگی، مشتری مجدداً در سایت ای‌تیپاکس شروع به ثبت سفارش می‌کند.

مشتری می‌تواند از قسمت «ثبت سفارش» برای ثبت سفارش اقدام کند.

نکته مهم: برای انتخاب کالایی که در نمایندگی تعریف کرده است، بعد از انتخاب نوع بسته‌بندی تعریف شده، باید مودال «افزودن نوع کالا» را انتخاب کند.
با تکمیل این مرحله، فرآیند ثبت سفارش فولفیلمنت با موفقیت انجام می‌شود و مرسوله از انبار نمایندگی ارسال خواهد شد.

🌐 راهنمای کانفیگ و اتصال به API تیپاکس در وبزی

🌐 وبسایت ای‌تیپاکس ⬇️ نسخه آفلاین راهنمایی وبزی
🎬 ویدیوی آموزشی ⏱️ مدت زمان: 6 دقیقه
📹 آموزش تصویری کامل کانفیگ وبزی و اتصال به API تیپاکس

مقدمه

در این راهنما، مراحل فعال‌سازی افزونه تیپاکس، انجام تنظیمات فروشگاه، تعریف روش ارسال و اتصال به API تیپاکس در وبسایت وبزی توضیح داده شده است. با انجام تنظیمات زیر، سفارش‌های ثبت‌شده در فروشگاه می‌توانند از طریق سرویس تیپاکس ارسال شوند و در صورت فعال بودن قابلیت مربوطه، فرآیند ایجاد بارکد و دریافت کد پیگیری نیز انجام خواهد شد.

⏱️ زمان مطالعه: حدود ۱۰ دقیقه 🌐 پلتفرم: وبزی 📦 ۷ مرحله

📋 مراحل گام‌به‌گام کانفیگ وبزی

1

فعال‌سازی افزونه تیپاکس

مرحله 1 از 7

پس از ایجاد وبسایت و انتشار آن، ابتدا وارد پنل مدیریت وبسایت وبزی شوید.

  1. از منوی مدیریت، وارد بخش افزونه‌ها شوید.
  2. در قسمت جستجوی افزونه‌ها، عبارت تیپاکس را جستجو کنید.
  3. افزونه تیپاکس را پیدا کرده و وضعیت آن را از غیرفعال به فعال تغییر دهید.
  4. پس از فعال‌سازی، پیام زیر نمایش داده می‌شود: «عملیات با موفقیت انجام شد.»
با مشاهده این پیام، افزونه تیپاکس با موفقیت روی سایت فعال شده است.
2

ورود به تنظیمات فروشگاه

مرحله 2 از 7

پس از فعال‌سازی افزونه:

  1. از پنل مدیریت، وارد بخش مدیریت فروشگاه شوید.
  2. از منوی سمت چپ، وارد بخش تنظیمات شوید.
  3. گزینه اطلاعات کسب‌وکار را انتخاب کنید.
در این بخش، تنظیمات عمومی مربوط به فروشگاه و اطلاعات موردنیاز برای فرآیند ارسال سفارش انجام می‌شود.
3

تعریف ابعاد بسته‌بندی

مرحله 3 از 7

در بخش ابعاد بسته‌بندی، ابعاد پیش‌فرض بسته‌هایی که قرار است توسط فروشگاه ارسال شوند را تعریف کنید. برای مثال، می‌توانید ابعاد استاندارد مورد استفاده خود را به‌عنوان ابعاد بسته‌بندی ثبت کنید.

نکته: ابعاد ثبت‌شده باید با ابعاد واقعی بسته‌های ارسالی همخوانی داشته باشد؛ زیرا این اطلاعات می‌تواند در محاسبه هزینه ارسال و پردازش سفارش مورد استفاده قرار گیرد.
4

تعریف مناطق ارسال

مرحله 4 از 7

پس از تنظیم ابعاد بسته‌بندی، وارد بخش روش‌های ارسال شوید.

در این قسمت:

  1. گزینه افزودن منطقه ارسال را انتخاب کنید.
  2. شهرهایی را که قصد دارید سفارش‌های آن‌ها از طریق تیپاکس ارسال شوند، به منطقه ارسال اضافه کنید.
  3. پس از تعریف منطقه، گزینه افزودن سرویس حمل‌ونقل جدید را انتخاب کنید.
  4. در قسمت سرویس‌های پستی، روش حمل‌ونقل تیپاکس را انتخاب کنید.
به این ترتیب، تیپاکس به‌عنوان یکی از روش‌های ارسال فروشگاه تعریف خواهد شد.
5

تنظیمات سرویس تیپاکس و اطلاعات API

مرحله 5 از 7

پس از انتخاب تیپاکس به‌عنوان روش حمل‌ونقل، تنظیمات مربوط به سرویس نمایش داده می‌شود. در این بخش، اطلاعات موردنیاز برای اتصال فروشگاه به API تیپاکس را وارد کنید.

🔑 اطلاعات احراز هویت API:

در قسمت‌های مربوط به:

  • نام کاربری
  • کلمه عبور
  • API

اطلاعات حساب کاربری و دسترسی API تیپاکس را وارد کنید.

نکته مهم: نام کاربری و کلمه عبور باید مربوط به حساب کاربری تیپاکس باشد که برای استفاده از سرویس API در نظر گرفته شده است. اطلاعات ورود را با دقت وارد کنید؛ در صورت اشتباه بودن اطلاعات احراز هویت، اتصال به API و ثبت سفارش با خطا مواجه خواهد شد.
6

تنظیم روش و زمان ارسال

مرحله 6 از 7

در ادامه تنظیمات، اطلاعات مربوط به روش ارسال و زمان انجام/تحویل سفارش را مطابق نیاز فروشگاه مشخص کنید. این تنظیمات تعیین می‌کنند که روش ارسال تیپاکس چگونه به مشتری نمایش داده شود و زمان ارسال یا تحویل سفارش در فروشگاه به چه صورت درج شود.

پس از تکمیل تنظیمات، آن‌ها را ذخیره کنید.
7

ثبت سفارش و ایجاد بارکد

مرحله 7 از 7

پس از انجام تنظیمات فوق، مشتری می‌تواند هنگام ثبت سفارش در وبسایت، روش ارسال تیپاکس را انتخاب کند. سفارش پس از ثبت در پنل مدیریت فروشگاه قابل مشاهده خواهد بود.

در صورتی که ایجاد خودکار بارکد برای سفارش فعال نباشد، می‌توان پس از تأیید سفارش، از طریق بخش مربوط به فعالیت‌ها اطلاعات ثبت سفارش را مشاهده کرد. در این قسمت، کد پیگیری / بارکد تیپاکس قابل مشاهده خواهد بود.

با تکمیل این مرحله، فرآیند اتصال وبزی به تیپاکس کامل شد!

⚠️ نکات مهم

  1. قبل از استفاده از سرویس، از صحت اطلاعات نام کاربری، کلمه عبور و API اطمینان حاصل کنید.
  2. شهرهای موردنظر برای ارسال باید در بخش مناطق ارسال تعریف شده باشند.
  3. روش حمل‌ونقل باید روی تیپاکس تنظیم شده باشد.
  4. ابعاد بسته‌بندی را متناسب با بسته‌های واقعی ارسالی تنظیم کنید.
  5. پس از انجام تنظیمات، ابتدا یک سفارش آزمایشی ثبت و فرآیند ایجاد سفارش و دریافت بارکد را بررسی کنید.
  6. در صورت عدم ایجاد خودکار بارکد، پس از تأیید سفارش، بخش فعالیت‌ها را بررسی کنید تا کد پیگیری یا بارکد سفارش قابل مشاهده باشد.
  7. در صورت بروز خطا هنگام ثبت سفارش، ابتدا اطلاعات اتصال API و تنظیمات سرویس ارسال را بررسی کنید.