Back to Details

israeli-shipping-manager

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Israeli Shipping Manager

以色列配送管理器

Instructions

使用说明

CRITICAL: This skill is a developer integration guide for BUILDING shipping workflows. You CANNOT look up live package tracking status. If a user asks "where is my package" or gives you a tracking number to check, you MUST:
  1. Direct them to check on the carrier's official website (Israel Post: mypost.israelpost.co.il, HFD: hfd.co.il, Cheetah: chita-il.com)
  2. NEVER fabricate or guess package status, pickup location, delivery address, branch name, opening hours, or any other tracking detail. You do not have access to any carrier's tracking system.
  3. If the user needs automated tracking, guide them to set up a tracking integration (Step 4 below) or recommend the 
    israel-post-tracking
    community skill for Israel Post packages.
重要提示：本技能是用于构建配送工作流的开发者集成指南，无法查询实时包裹跟踪状态。如果用户询问“我的包裹在哪里”或提供运单号要求查询，必须执行以下操作：
  1. 引导他们前往承运商官方网站查询（Israel Post：mypost.israelpost.co.il，HFD：hfd.co.il，Cheetah：chita-il.com）
  2. 绝不能编造或猜测包裹状态、取件地点、配送地址、网点名称、营业时间或任何其他跟踪细节。你无法访问任何承运商的跟踪系统。
  3. 如果用户需要自动化跟踪服务，引导他们搭建跟踪集成（见下文步骤4），或推荐针对Israel Post包裹的
    israel-post-tracking
    社区技能。

Step 1: Select Carrier Based on Shipment

步骤1：根据包裹选择承运商

Help the user choose the right carrier for their shipment. Ask about parcel size, weight, delivery urgency, destination, and budget. Use this comparison table:
CarrierBest ForSpeedPrice RangePickup PointsIntegration
Israel Post (דואר ישראל)Standard parcels, nationwide coverage3-5 business daysLow-mediumPost offices + BOX2GO lockersDatalogics API, open-source libraries
Cheetah (צ'יטה)Same-day/express deliverySame day (often within 4 hours)Medium-highLimitedShopify app, private B2B API
HFD (Hameritz & Flash)E-commerce fulfillment2-4 business daysMedium~1,000 pickup points + lockersShopify/WooCommerce plugins, private API
Mahir Li (מהיר לי)Same-day B2B courierSame day (within 9 hours)Medium-highDoor-to-door onlyVia LionWheel platform
Additional courier companies use Baldar delivery management software (Tapuz, Hafoz, Isgav, Mach1). If a user mentions "Baldar," ask which specific courier company they use, as Baldar is software, not a carrier.
Locker/pickup services (not standalone carriers):
ServiceOperatorLocationsNotes
BOX2GOIsrael Post + Paz~120 Yellow Box lockers at Paz gas stationsIntegrated with Israel Post shipping
ShlagerOrianMobile smart lockers in residential areasAutomated locker network
DoneDone (done.co.il)Lockers at various locations~30 NIS/package, max 5 kg, 3 business days
SafeLockerSafeLockerMalls and shopping centersLocker-based pickup
HFD PointsHFD~1,000 nationwidePart of HFD delivery network
Selection criteria:
  • Delivery speed: Same-day requires Cheetah or Mahir Li; standard allows all carriers
  • Parcel size/weight: Heavy or oversized items may limit carrier options. Locker services have size limits.
  • Destination area: Center (Gush Dan) has full coverage; periphery (Eilat, Galilee) may have limited options for some carriers
  • Budget: Israel Post is cheapest for standard; Cheetah and Mahir Li are premium for speed
  • Pickup vs door-to-door: BOX2GO/HFD/Done for self-service pickup; Cheetah/Mahir Li for guaranteed door delivery
  • Volume: Mahir Li requires minimum 10 deliveries/day; Israel Post and HFD have no minimums
帮助用户为其包裹选择合适的承运商。询问包裹尺寸、重量、配送时效要求、目的地和预算。参考以下对比表：
承运商适用场景配送时效价格区间自提点集成方式
Israel Post (דואר ישראל，以色列邮政)标准包裹、全国覆盖3-5个工作日低-中等邮局 + BOX2GO自提柜Datalogics API、开源库
Cheetah (צ'יטה)当日/加急配送当日（通常4小时内）中-高数量有限Shopify应用、私有B2B API
HFD (Hameritz & Flash)电商履约配送2-4个工作日中等约1000个自提点 + 自提柜Shopify/WooCommerce插件、私有API
Mahir Li (מהיר לי)当日B2B courier当日（9小时内）中-高仅门到门配送通过LionWheel平台集成
其他部分快递公司使用Baldar配送管理软件（Tapuz、Hafoz、Isgav、Mach1）。如果用户提到“Baldar”，请询问他们具体使用哪家快递公司，因为Baldar是软件而非承运商。
自提柜/自提服务（非独立承运商）：
服务运营商位置说明
BOX2GOIsrael Post + PazPaz加油站内约120个黄色自提柜与Israel Post配送集成
ShlagerOrian居民区移动智能柜自动化自提柜网络
DoneDone (done.co.il)多地点自提柜约30新谢克尔/包裹，最大5公斤，3个工作日
SafeLockerSafeLocker商场及购物中心柜式自提
HFD PointsHFD全国约1000个网点HFD配送网络的一部分
选择标准：
  • 配送时效：当日配送需选择Cheetah或Mahir Li；标准配送可选所有承运商
  • 包裹尺寸/重量：重型或超大件可能限制承运商选择。自提柜服务有尺寸限制
  • 目的地区域：中心区域（Gush Dan）覆盖完整；偏远地区（埃拉特、加利利）部分承运商服务有限
  • 预算：Israel Post是标准配送最便宜的选择；Cheetah和Mahir Li是时效优先的高端选项
  • 自提 vs 门到门：BOX2GO/HFD/Done适合自助取件；Cheetah/Mahir Li提供门到门配送保障
  • 配送量：Mahir Li要求每日至少10单配送；Israel Post和HFD无最低配送量要求

Step 2: Format Israeli Address

步骤2：格式化以色列地址

Format addresses correctly per carrier requirements. Run 
python scripts/format_address.py --validate
to check format before submission. See references/address-format.md for the complete format specification.
Required fields:
  • Street name (שם רחוב) -- in Hebrew
  • House number (מספר בית)
  • Apartment number (דירה) -- if applicable
  • Entrance (כניסה) -- if applicable (common in older buildings)
  • Floor (קומה) -- if applicable
  • City (עיר) -- in Hebrew
  • Mikud/ZIP (מיקוד) -- 7 digits
Special handling:
  • Military addresses (APO): Use IDF address format (מספר צבאי). Only Israel Post handles military mail.
  • Kibbutzim/Moshavim: Settlement name + house number (no street)
  • Industrial zones: Area name + building/company name
  • Arab localities: Verify transliteration matches carrier database
根据承运商要求正确格式化地址。提交前运行
python scripts/format_address.py --validate
检查格式。完整格式规范请参考references/address-format.md。
必填字段：
  • 街道名称（שם רחוב） -- 希伯来语
  • 门牌号（מספר בית）
  • 公寓号（דירה） -- 如有
  • 入口（כניסה） -- 如有（老旧建筑常见）
  • 楼层（קומה） -- 如有
  • 城市（עיר） -- 希伯来语
  • 邮政编码（מיקוד） -- 7位数字
特殊处理：
  • 军事地址（APO）：使用IDF地址格式（מספר צבאי）。仅Israel Post处理军事邮件
  • 基布兹/莫沙夫：定居点名称 + 门牌号（无街道）
  • 工业区：区域名称 + 建筑/公司名称
  • 阿拉伯聚居区：确认音译与承运商数据库匹配

Step 3: Generate Shipping Label

步骤3：生成运单标签

Label generation depends on the carrier's integration method:
  • Israel Post: Use the Datalogics API (
    connect.datalogics.co.il/rest/w_create_shipping
    ) or the Israel Post Business Portal (mybusiness.israelpost.co.il)
  • Cheetah: Use the "Cheetah DeliverIt" Shopify app, or contact Cheetah sales for direct integration
  • HFD: Use the "HFD DeliverIt" Shopify app or the "HFD ePost Integration" WooCommerce plugin. HFD also offers a private API for direct integration (contact HFD).
  • Mahir Li: Integration via LionWheel platform (lionwheel.com). Contact Mahir Li for business account setup.
All labels require:
  • Sender details (name, address, phone)
  • Recipient details (name, address, phone)
  • Parcel dimensions and weight
  • Service type (standard, express, registered)
  • Tracking barcode
See references/carrier-apis.md for per-carrier integration details.
标签生成方式取决于承运商的集成方法：
  • Israel Post：使用Datalogics API（
    connect.datalogics.co.il/rest/w_create_shipping
    ）或Israel Post商家门户（mybusiness.israelpost.co.il）
  • Cheetah：使用“Cheetah DeliverIt”Shopify应用，或联系Cheetah销售团队获取直接集成权限
  • HFD：使用“HFD DeliverIt”Shopify应用或“HFD ePost Integration”WooCommerce插件。HFD也提供私有API用于直接集成（需联系HFD）
  • Mahir Li：通过LionWheel平台（lionwheel.com）集成。需联系Mahir Li开通商家账户
所有标签需包含：
  • 寄件人信息（姓名、地址、电话）
  • 收件人信息（姓名、地址、电话）
  • 包裹尺寸和重量
  • 服务类型（标准、加急、挂号）
  • 跟踪条形码
各承运商集成细节请参考references/carrier-apis.md。

Step 4: Set Up Cross-Carrier Tracking

步骤4：搭建跨承运商跟踪系统

Important: This step is about BUILDING a tracking system for your application, not about looking up individual package statuses. If the user wants to check a specific package right now, direct them to the carrier's website (see the critical note at the top of Instructions).
No Israeli carrier offers a public REST tracking API. Implement unified tracking using one of these approaches:
Option A: Third-party aggregator (recommended) Use AfterShip, TrackingMore, or WeShip for unified tracking across carriers. These provide documented REST APIs with webhooks.
Option B: Direct integration per carrier
  • Israel Post: Scrape tracking via 
    mypost.israelpost.co.il
    (requires CSRF token handling) or use open-source libraries (
    bennymeg/IsraelPostalServiceAPI
    , 
    LandRover/postil-status
    )
  • HFD: Track via hfd.co.il or AfterShip
  • Cheetah: Track via the RUN system (chita-il.com) or the Shopify app
  • Mahir Li: Track via LionWheel
Normalize status codes to a common set: 
pending
, 
picked_up
, 
in_transit
, 
out_for_delivery
, 
delivered
, 
failed_delivery
, 
returned
Poll at configurable intervals (default: every 2 hours). Detect anomalies: package stuck in same status for >48 hours, delivery failures, address corrections.
注意：本步骤是为你的应用构建跟踪系统，而非查询单个包裹的状态。如果用户现在想查询特定包裹，请引导他们前往承运商官网（见使用说明顶部的重要提示）。
以色列没有承运商提供公开的REST跟踪API。可通过以下方式实现统一跟踪：
方案A：第三方聚合服务（推荐） 使用AfterShip、TrackingMore或WeShip实现跨承运商统一跟踪。这些服务提供文档化的REST API和webhooks。
方案B：针对单个承运商直接集成
  • Israel Post：通过
    mypost.israelpost.co.il
    抓取跟踪信息（需处理CSRF令牌）或使用开源库（
    bennymeg/IsraelPostalServiceAPI
    、
    LandRover/postil-status
    ）
  • HFD：通过hfd.co.il或AfterShip跟踪
  • Cheetah：通过RUN系统（chita-il.com）或Shopify应用跟踪
  • Mahir Li：通过LionWheel跟踪
将状态代码标准化为通用集合：
pending
、
picked_up
、
in_transit
、
out_for_delivery
、
delivered
、
failed_delivery
、
returned
按可配置间隔轮询（默认：每2小时一次）。检测异常：包裹状态超过48小时未更新、配送失败、地址修正。

Step 5: Configure Customer Notifications

步骤5：配置客户通知

Set up automated customer notifications on status changes:
  • Shipped: WhatsApp/SMS with tracking number and estimated delivery -- "החבילה שלך נשלחה! מספר מעקב: [X]. צפי הגעה: [DATE]."
  • Out for delivery: "החבילה שלך בדרך אליך! צפי הגעה היום עד [TIME]."
  • Delivered: "החבילה נמסרה בהצלחה! תודה על הקנייה."
  • Failed delivery: "לא הצלחנו למסור את החבילה. נסיון נוסף מתוכנן ל-[DATE]. לתיאום: [PHONE]."
  • Pickup ready: "החבילה שלך מחכה לך בנקודת [BOX2GO/HFD/Done] ב-[LOCATION]. קוד איסוף: [CODE]."
Respect quiet hours: no notifications between 22:00-08:00 Israel time.
设置状态变更时的自动化客户通知：
  • 已发货：WhatsApp/SMS发送运单号和预计送达时间 -- "החבילה שלך נשלחה! מספר מעקב: [X]. צפי הגעה: [DATE]."
  • 配送中："החבילה שלך בדרך אליך! צפי הגעה היום עד [TIME]."
  • 已送达："החבילה נמסרה בהצלחה! תודה על הקנייה."
  • 配送失败："לא הצלחנו למסור את החבילה. נסיון נוסף מתוכנן ל-[DATE]. לתיאום: [PHONE]."
  • 可取件："החבילה שלך מחכה לך בנקודת [BOX2GO/HFD/Done] ב-[LOCATION]. קוד איסוף: [CODE]."
遵守静默时段：以色列时间22:00-08:00之间不发送通知。

Step 6: Handle Returns and RMA

步骤6：处理退货与RMA

Manage return shipments:
  • Generate return label with original tracking reference
  • Track return shipment back to seller
  • Support different return reasons: defective, wrong item, changed mind (14-day consumer protection per Israeli Consumer Protection Law)
  • Calculate return shipping cost by carrier
  • Update order status when return is received
管理退货配送：
  • 使用原始跟踪参考生成退件标签
  • 跟踪退件返回卖家的状态
  • 支持不同退货原因：商品缺陷、发错货、买家反悔（根据以色列消费者保护法，支持14天无理由退换）
  • 计算各承运商的退件配送成本
  • 收到退件后更新订单状态

Examples

示例

Example 1: E-commerce Seller Shipping 50 Packages via Mixed Carriers

示例1：电商卖家通过多家承运商配送50个包裹

User says: "I need to ship 50 orders today, mix of sizes. Some need next-day to Tel Aviv, rest are standard nationwide." Actions:
  1. Analyze orders by size, destination, and urgency
  2. Route express Tel Aviv orders to Cheetah via their Shopify app (12 parcels)
  3. Route standard parcels to Israel Post or HFD (38 parcels) based on cost and plugin availability
  4. Format all addresses and validate mikud codes using 
    scripts/format_address.py
  5. Generate shipping labels per carrier integration method
  6. Set up unified tracking via AfterShip and configure WhatsApp notifications Result: 50 shipping labels generated across 3 carriers. Tracking dashboard set up with WhatsApp notifications configured for each customer.
用户需求：“我今天需要配送50个订单，包裹尺寸不一。部分需要次日送达特拉维夫，其余为全国标准配送。” 操作步骤：
  1. 按尺寸、目的地和时效要求分析订单
  2. 将特拉维夫加急订单通过Cheetah的Shopify应用配送（12个包裹）
  3. 根据成本和插件可用性，将标准包裹分配给Israel Post或HFD（38个包裹）
  4. 格式化所有地址并使用
    scripts/format_address.py
    验证邮政编码
  5. 根据各承运商的集成方式生成运单标签
  6. 通过AfterShip搭建统一跟踪系统并配置WhatsApp通知 结果：生成3家承运商的50份运单标签。搭建跟踪仪表盘并为每位客户配置WhatsApp通知。

Example 2: Setting Up HFD Pickup Point Integration for a Shopify Store

示例2：为Shopify店铺搭建HFD自提点集成

User says: "I want to offer HFD pickup point as an option for my online store on Shopify." Actions:
  1. Install "HFD DeliverIt" app from the Shopify App Store
  2. Configure HFD business account credentials in the app
  3. Enable HFD pickup points as a shipping option at checkout
  4. Set up tracking notifications: customers get SMS when package arrives at pickup point
  5. Configure auto-tracking from shipment to customer pickup Result: HFD integration active. Customers can select from ~1,000 HFD pickup points at checkout and receive pickup notifications.
用户需求：“我想为我的Shopify在线店铺提供HFD自提选项。” 操作步骤：
  1. 从Shopify应用商店安装“HFD DeliverIt”应用
  2. 在应用中配置HFD商家账户凭证
  3. 在结账环节启用HFD自提点作为配送选项
  4. 设置跟踪通知：包裹到达自提点时向客户发送SMS
  5. 配置从发货到客户取件的自动跟踪 结果：HFD集成生效。客户可在结账时从约1000个HFD自提点中选择，并收到取件通知。

Example 3: Rate Comparison for Heavy Parcel to Eilat

示例3：发往埃拉特的重型包裹费率对比

User says: "I need to ship a 15kg package to Eilat, what are my options?" Actions:
  1. Check carrier availability for Eilat (periphery area)
  2. Use Israel Post rate calculator (public, no auth needed) via 
    bennymeg/IsraelPostalServiceAPI
    library
  3. Contact HFD for a rate quote (no public rate API)
  4. Note: Mahir Li requires 10+ daily deliveries, likely not suitable for single parcels
  5. Cheetah serves Eilat (branch there) but at premium pricing
  6. Compare delivery times and costs Result: Israel Post is the most accessible option with public rate calculation. For better rates on volume, contact HFD directly.
用户需求：“我需要寄送一个15公斤的包裹到埃拉特，有哪些选择？” 操作步骤：
  1. 检查埃拉特（偏远地区）的承运商服务覆盖情况
  2. 通过
    bennymeg/IsraelPostalServiceAPI
    库使用Israel Post费率计算器（公开、无需授权）
  3. 联系HFD获取报价（无公开费率API）
  4. 注意：Mahir Li要求每日至少10单配送，不适合单个包裹
  5. Cheetah服务覆盖埃拉特（当地有网点）但价格较高
  6. 对比配送时效和成本 结果：Israel Post是最易获取的选项，支持公开费率计算。如需批量配送更优惠费率，请直接联系HFD。

Bundled Resources

捆绑资源

References

参考文档

  • references/carrier-apis.md
    -- Verified integration methods for each Israeli carrier: Israel Post (Datalogics API, open-source libraries), Cheetah (Shopify app, RUN system), HFD (Shopify/WooCommerce plugins), Mahir Li (LionWheel), locker services, and third-party aggregators. Consult when integrating with a specific carrier in Steps 3-4.
  • references/address-format.md
    -- Complete Israeli address formatting specification: street, house, apartment, entrance, floor, city, mikud. Includes special formats for kibbutzim, military addresses, and industrial zones. Consult when formatting addresses in Step 2.
  • references/carrier-apis.md
    -- 各以色列承运商的已验证集成方式：Israel Post（Datalogics API、开源库）、Cheetah（Shopify应用、RUN系统）、HFD（Shopify/WooCommerce插件）、Mahir Li（LionWheel）、自提柜服务及第三方聚合服务。步骤3-4中集成特定承运商时参考。
  • references/address-format.md
    -- 完整的以色列配送地址格式化规范：街道、门牌号、公寓号、入口、楼层、城市、邮政编码。包含基布兹、军事地址和工业区的特殊格式。步骤2中格式化地址时参考。

Scripts

脚本

  • scripts/format_address.py
    -- Validates and formats Israeli shipping addresses per carrier requirements. Checks mikud (ZIP) validity, normalizes Hebrew text, and handles special address types (kibbutz, military, industrial zone). Run: 
    python scripts/format_address.py --help
  • scripts/format_address.py
    -- 根据承运商要求验证并格式化以色列配送地址。检查邮政编码有效性、标准化希伯来文本、处理特殊地址类型（基布兹、军事地址、工业区）。运行方式：
    python scripts/format_address.py --help

Related Skills

相关技能

For live Israel Post package tracking, use the israel-post-tracking skill:
SkillWhat it doesLink
Israel Post TrackingTrack packages via Israel Post using Puppeteer with headless Chrome. One-shot status lookup or ongoing monitoring with WhatsApp notifications on status changes. Requires Google Chrome installed.View skill
This shipping-manager skill is a developer integration guide for building shipping workflows. It does NOT track packages. If a user asks "where is my package?", either use the 
israel-post-tracking
skill (if installed) or direct them to the carrier's official website. NEVER fabricate package status, pickup location, or delivery information.
如需实时查询Israel Post包裹状态，请使用israel-post-tracking技能：
技能功能链接
Israel Post Tracking使用Puppeteer和无头Chrome跟踪Israel Post包裹。支持单次状态查询或持续监控，状态变更时发送WhatsApp通知。需安装Google Chrome。查看技能
本shipping-manager技能是用于构建配送工作流的开发者集成指南，不提供包裹跟踪功能。如果用户询问“我的包裹在哪里？”，若已安装
israel-post-tracking
技能则使用该技能，否则引导用户前往承运商官方网站。绝不能编造包裹状态、取件地点或配送信息。

Gotchas

注意事项

  • NEVER fabricate package tracking results. You cannot access any carrier's tracking system. If a user provides a tracking number and asks "where is my package," do NOT invent a status, pickup location, branch name, address, or opening hours. Agents that fabricate tracking data provide dangerously wrong information (e.g., telling a user their package is at a specific store when it was already delivered to a different city). Always direct the user to the carrier's official tracking page.
  • Israeli carriers do not offer publicly documented REST APIs. Integration is done through platform plugins (Shopify, WooCommerce), private B2B agreements, or third-party aggregators. Agents may attempt to call fabricated API endpoints that do not exist.
  • Israel Post delivery zones differ from geographic regions. Shipping time estimates should use Israel Post zone mappings, not straight-line distance calculations.
  • Israeli addresses do not use ZIP codes in the US format. Israeli postal codes (mikud) are 7 digits. Agents may validate against 5-digit US ZIP code patterns.
  • Friday deliveries in Israel end by early afternoon (before Shabbat). Same-day delivery services do not operate Friday afternoon through Saturday evening.
  • Israeli settlement addresses in the West Bank require special shipping handling and may not be supported by all carriers. Verify carrier coverage for these areas.
  • COD (cash on delivery) is still common in Israeli e-commerce. Agents may not include this payment option when setting up shipping flows.
  • Baldar is delivery management software, not a carrier. If a user says "I ship with Baldar," they mean a courier that uses Baldar (Tapuz, Hafoz, Isgav, Mach1). Ask which carrier specifically.
  • Israel Post's website uses bot protection (ShieldSquare/PerimeterX). Automated scraping of tracking or rate data may be blocked. Use the open-source libraries or Datalogics API instead.
  • 绝不能编造包裹跟踪结果。你无法访问任何承运商的跟踪系统。如果用户提供运单号并询问“我的包裹在哪里”，不要编造状态、取件地点、网点名称、地址或营业时间。编造跟踪数据会提供严重错误的信息（例如，告知用户包裹在某店铺，实际已送达其他城市）。始终引导用户前往承运商官方跟踪页面。
  • 以色列承运商不提供公开文档化的REST API。集成需通过平台插件（Shopify、WooCommerce）、私有B2B协议或第三方聚合服务实现。请勿尝试调用不存在的虚构API端点。
  • Israel Post的配送区域与地理区域不同。配送时效估算应使用Israel Post的区域映射，而非直线距离计算。
  • 以色列地址不使用美国格式的邮政编码。以色列邮政编码（mikud）为7位数字。请勿按5位美国邮政编码模式验证。
  • 以色列周五配送在下午早些时候结束（安息日前）。当日配送服务周五下午至周六晚间不运营。
  • 约旦河西岸的以色列定居点地址需要特殊配送处理，可能不被所有承运商支持。请验证承运商的服务覆盖范围。
  • COD（货到付款）在以色列电商中仍很常见。搭建配送流程时请勿遗漏该支付选项。
  • Baldar是配送管理软件，而非承运商。如果用户说“我使用Baldar配送”，他们指的是使用Baldar的快递公司（Tapuz、Hafoz、Isgav、Mach1）。请询问具体是哪家承运商。
  • Israel Post网站使用反机器人保护（ShieldSquare/PerimeterX）。自动抓取跟踪或费率数据可能被拦截。请使用开源库或Datalogics API替代。

Troubleshooting

故障排除

Error: "Invalid mikud (ZIP code)"

错误：“Invalid mikud (ZIP code)”

Cause: Israeli mikud must be exactly 7 digits and match the city/street combination. Solution: Verify mikud at Israel Post's mikud lookup (mypost.israelpost.co.il/zipcodesearch). Common issue: old 5-digit codes -- all Israeli ZIP codes are now 7 digits.
原因：以色列邮政编码必须为7位数字，且与城市/街道匹配。 解决方案：在Israel Post的邮政编码查询页面（mypost.israelpost.co.il/zipcodesearch）验证邮政编码。常见问题：使用旧的5位编码——所有以色列邮政编码现为7位。

Error: "Carrier API endpoint not found" or "404 on API call"

错误：“Carrier API endpoint not found”或“404 on API call”

Cause: Israeli carriers do not have publicly documented REST APIs. The endpoint you are calling likely does not exist. Solution: Check references/carrier-apis.md for the correct integration method. Use platform plugins (Shopify, WooCommerce), the Datalogics API for Israel Post, or a third-party aggregator (AfterShip, WeShip).
原因：以色列承运商没有公开文档化的REST API。你调用的端点很可能不存在。 解决方案：查看references/carrier-apis.md获取正确的集成方式。使用平台插件（Shopify、WooCommerce）、Israel Post的Datalogics API或第三方聚合服务（AfterShip、WeShip）。

Error: "Address not recognized by carrier"

错误：“Address not recognized by carrier”

Cause: Address format doesn't match carrier's database, or Hebrew text encoding issue. Solution: Ensure address uses UTF-8 encoded Hebrew. Run 
scripts/format_address.py --validate
to check format. For Arab localities, verify the carrier accepts the specific spelling. Try alternative transliterations.
原因：地址格式不符合承运商数据库要求，或希伯来文本编码问题。 解决方案：确保地址使用UTF-8编码的希伯来语。运行
scripts/format_address.py --validate
检查格式。对于阿拉伯聚居区，验证承运商是否接受特定拼写。尝试替代音译方式。

Error: "Delivery failed -- recipient not found"

错误：“Delivery failed -- recipient not found”

Cause: Common for apartment buildings without intercom or missing entrance/floor details. Solution: Add entrance (כניסה) and floor (קומה) to address. Configure delivery notification to include recipient phone for courier contact. Consider switching to pickup point (HFD/BOX2GO) for repeat-failure addresses.
原因：常见于无对讲机的公寓楼，或缺少入口/楼层信息。 解决方案：在地址中添加入口（כניסה）和楼层（קומה）。配置配送通知包含收件人电话，方便快递员联系。对于多次配送失败的地址，考虑切换到自提点（HFD/BOX2GO）。

Error: "Tracking data not updating"

错误：“Tracking data not updating”

Cause: Israel Post tracking endpoint requires CSRF token that expires. Bot protection may block automated requests. Solution: Use the 
LandRover/postil-status
or 
bennymeg/IsraelPostalServiceAPI
open-source libraries which handle token refresh. Alternatively, use a third-party aggregator like AfterShip for reliable tracking.
原因：Israel Post跟踪端点需要的CSRF令牌会过期。反机器人保护可能拦截自动请求。 解决方案：使用
LandRover/postil-status
或
bennymeg/IsraelPostalServiceAPI
开源库，这些库会处理令牌刷新。或者使用AfterShip等第三方聚合服务实现可靠跟踪。

User asks: "Where is my package?" or provides a tracking number

用户询问：“Where is my package?”或提供运单号

Cause: The user wants a live status lookup, not a shipping integration guide. Solution: This skill cannot look up live tracking data. Direct the user to the carrier's official tracking page: Israel Post (mypost.israelpost.co.il), HFD (hfd.co.il), or Cheetah (chita-il.com). For automated Israel Post tracking, recommend the 
israel-post-tracking
community skill. NEVER guess or fabricate the package status.
原因：用户需要实时状态查询，而非配送集成指南。 解决方案：本技能无法查询实时跟踪数据。引导用户前往承运商官方跟踪页面：Israel Post（mypost.israelpost.co.il）、HFD（hfd.co.il）或Cheetah（chita-il.com）。如需自动化Israel Post跟踪，推荐
israel-post-tracking
社区技能。绝不能猜测或编造包裹状态。