Skip to content

Test mode

A tjy_test_ key runs every Shipment with a simulated partner. Use it to build and test your integration end to end, including webhooks and the event stream.

  • Tujyane bills nothing, and TEST Shipments do not count toward your credit limit.

  • No real partner sees a TEST Shipment.

  • A quote always answers partnersAvailable: true and pickupEtaSeconds: 300.

  • The partner is always the same:

    {
    "firstName": "Test Partner",
    "phone": "250780000000",
    "vehicle": { "type": "MOTORCYCLE", "plate": "RAC 000T", "model": "Test motorcycle", "color": null }
    }
  • A cancellation after assignment answers offence: true, but Tujyane records nothing.

  • Expiry, cancel, retry, not-received and every error work as in live mode.

  • With Delivery Codes on, the simulated partner enters the right code, so deliveryConfirmedBy is CODE. Otherwise it is PARTNER. It delivers at the drop-off point.

Put a keyword in the Shipment’s reference to choose what happens:

reference contains Outcome
No keyword Delivered
unreachable Fails with RECIPIENT_UNREACHABLE, then returned
refused Fails with REFUSED, then returned
wrong-address Fails with WRONG_ADDRESS, then returned
damaged Fails with DAMAGED, then returned
no-partner NO_PARTNER_FOUND

The match ignores case. Tujyane checks the words in this order and uses the first match: no-partner, unreachable, refused, wrong-address, damaged. For example, IH-20482-no-partner gives NO_PARTNER_FOUND, and IH-20483-refused gives REFUSED.

A retried Shipment always follows the default timeline, so a no-partner Shipment that you retry is delivered.

After you confirm, the simulated partner follows this timeline. Each step waits for the one before it, so a run can finish 10 to 30 seconds later than shown.

Seconds after confirm Delivered Failed (keyword) no-partner
5 shipment.assigned shipment.assigned shipment.no_partner_found
15 shipment.partner_arrived_pickup shipment.partner_arrived_pickup
25 shipment.picked_up shipment.picked_up
28 to 52 partner.position every 3 seconds (stream only) Same
45 shipment.partner_arriving shipment.partner_arriving
55 shipment.delivered shipment.delivery_failed
65 shipment.returned
30 minutes after no_partner_found The retry window closes, with no event.