Skip to content
FOPilot

Nova Poshta waybills from orders

How FOPilot turns store orders into Nova Poshta waybills, handles ambiguous addresses, cash on delivery and bulk creation with a dry run.

Flow for one order: read the order → resolve the city (fuzzy, understands Russian/Latin names of major cities; uses the branch Ref if the store supplies it) → resolve the branch or parcel locker by number and street → check branch status, weight limit, parcel-locker size and declared-value limits → apply sender and parcel defaults (declared value = order total) → add cash on delivery for unpaid COD orders (money transfer, or "payment control" when the seller has a contract) → create the waybill → write the number back to the store order.

Ambiguity: when the city or branch cannot be resolved with confidence ≥ 0.9, nothing is created. The tool returns status: needs_choice with candidates (label, Ref, score); the user picks one and the call is repeated with warehouse_ref or city_ref.

Bulk (Pro/Business): np_create_waybills_bulk with dry_run=true (default) returns a plan (ready / needs_choice / skipped / error, COD total) and a plan_id; dry_run=false with that plan_id creates only ready items and is metered per created waybill.

Labels: results include short-lived signed links to the waybill PDF (A4) or 100×100 label; the Nova Poshta API key is never exposed.

Deleting: np_delete_waybill (destructive) works until the parcel is accepted by Nova Poshta.