HugeProfitCRM Documentation UALog in
Sales and orders

How to create an Ukrposhta waybill in HugeProfit

You create an Ukrposhta waybill (TTN) right from a sale in HugeProfit: the recipient's details and the amount are filled in automatically, you choose Standard or Express, print the parcel sticker, and HugeProfit tracks the shipment status on its own. You need a contract with Ukrposhta and two API keys from their email.

One-time setup

  • A contract with Ukrposhta for a sole proprietor or company. After signing, Ukrposhta emails you the keys; HugeProfit needs two of them: PRODUCTION BEARER eCom and COUNTERPARTY TOKEN.
  • Integration: Settings → Integration → Delivery → Ukrposhta → Connect, then the keys and sender details (phone, name, postal code, tax ID, IBAN). Step by step: see the Ukrposhta article.

💡 Without the integration, you can enter a waybill created at the branch or in your Ukrposhta account into the sale manually, and HugeProfit will still track the parcel.

How to create an Ukrposhta waybill

  1. Create a sale with delivery: the Delivery tab → Delivery Service: Ukrposhta, the client (last name, first name, phone), and the recipient's branch. If the client pays on delivery, choose the C.O.D account.
  2. Sales → Awaiting dispatch → in the sale row, 🚚 Send parcel/Finish → Create Ukrposhta shipment label.
  3. Fill in the form:
    FieldWhat to enter
    SenderFilled in from the integration. With several contracts, choose the right one.
    RecipientFilled in from the sale; check the branch (postal code).
    TypeStandard or Express (faster and more expensive).
    Dimensions, WeightLength must be the longest side. Empty fields are sent as 10×10×10 cm and 1 kg.
    Who pays for deliverySender or recipient.
    PaymentDeclared value: the item is already paid for. COD: Postpayment (credit to card) or Postpayment (credit to account) to the IBAN from the settings; crediting to an account requires separate permission from Ukrposhta.
    Parcel description (50 characters)What's in the parcel.
  4. Create the waybill. The number is saved to the sale, and the sale moves to On delivery.

Printing the sticker

After creating the waybill, print the label (sticker) for the parcel: a PDF in the format Ukrposhta generates. You can print it again later from the sale row, using the print icon next to the waybill number.

In bulk: select the sales with waybills → Printing Tracking #, and the stickers are combined into one PDF (up to 100 per file). The same file can also include Nova Poshta waybills.

Tracking and cash on delivery

  • HugeProfit checks Ukrposhta waybills about every 30 minutes and updates the sale status on its own: On delivery, Waiting at the branch, Sold or Collect COD, Refusal to receive.
  • When Ukrposhta transfers the COD money, click Collect COD on the Collect COD tab, including for many sales at once (how to do it).

Common errors

ErrorWhat to do
“Length must have the largest value”Enter the longest side of the parcel in the length field.
“There must be an agreement for postpaid payment to a bank account”Ukrposhta hasn't yet allowed COD to your IBAN. Until it does, choose Postpayment (credit to card). How to get permission: see the Ukrposhta article.
Authorization errorCheck that you pasted the PRODUCTION keys, not SANDBOX, and that BEARER and TOKEN aren't swapped.
There's no button to create an Ukrposhta waybillUkrposhta isn't selected in the sale, or the integration isn't connected.

For what HugeProfit offers for Ukrposhta shipping, see Creating Ukrposhta waybills. The shipping flow for all carriers: Delivery and waybills; for Nova Poshta: How to create and print a Nova Poshta waybill.

Type a word or a question