Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A Buy Order is a purchase order where your Office is purchasing tickets from another Office and there is no corresponding sale to a Client or anyone else. You might create a Buy Order if you are simply looking to purchase tickets to add to your own inventory. Please see the Orders / Create documentation for more info.

Physical Tickets Shipping via FedEx

Create a Buy order Order for physical tickets that will ship via FedEx. In this example, a broker named “TEvo POS Test - Main Office (1937)” is buying two tickets for themselves. 

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 453545078,
              "quantity": 2,
              "price": 5
            }
          ],
          "type": "FedEx",
          "service_type": "LEAST_EXPENSIVE",
          "signature_type": "INDIRECT",
          "residential": true,
          "ship_to_company_name": "TEvo POS Test - Main Office",
          "ship_to_name": "Jackie Martinoski",
          "address_attributes": {
            "street_address": "9060 East Via Linda",
            "extended_address": "Suite 230",
            "locality": "Scottsdale",
            "region": "AZ",
            "postal_code": "85258",
            "country_code": "US"
          },
          "phone_number_attributes": {
            "extension": "5",
            "number": "972-468-9750",
            "is_primary": false
          }
        }
      ],
      "payments": [
        {
          "type": "evopay"
        }
      ],
      "buyer_id": 1937,
      "buyer_reference_number": "123456789",
      "external_notes": "These notes will be visible to all parties",
      "internal_notes": "These notes will be visible only to your office (1937)"
    }
  ]
}

...

Physical Tickets with Local Pick Up

Create a Buy /Sell order for Order for physical tickets when it is too late to ship and the tickets must be picked up locally by the consumer, or perhaps the buyer knows the seller is nearby and prefers to pick them up in person. In this example, a broker named “TEvo POS Test - Main Office (1937)” is selling buying two tickets to their client, Ned Flanders (167895)for themselves

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 453545078,
              "quantity": 2,
              "price": 5
            }
          ],
          "type": "LocalPickup",
          "ship_to_name": "Jackie Martinoski",
          "notes": "Please contact Jackie to arrange when and where to pick up these tickets.",
          "phone_number_attributes": {
            "extension": "5",
            "number": "972-468-9750",
            "is_primary": false
          }
        }
      ],
      "payments": [
        {
          "type": "evopay"
        }
      ],
      "buyer_id": 1937,
      "buyer_reference_number": "123456789",
      "external_notes": "These notes will be visible to all parties",
      "internal_notes": "These notes will be visible only to your office (1937)"
    }
  ]
}

Print at Home Tickets (Etickets)

Create a Buy /Sell order Order for Print at Home tickets (Etickets) that are delivered as a PDF file. In this example, a broker named “TEvo POS Test - Main Office (1937)” is selling buying two tickets to their client, Ned Flanders (167895)for themselves

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 385270025453544998,
              "quantity": 2,
              "price": 512
            }
          ],
          "type": "Eticket",
        }
 "email_address_id": 333333         }
      ],
      "billing_address_id": 111111],
      "payments": [
        {
          "type": "credit_cardevopay",
          "credit_card_id": 22222
        }
      ],
      "sellerbuyer_id": 1937,
      "clientbuyer_reference_idnumber": 167895"123456789",
      "created_by_ip_addressexternal_notes": "12.34.56.78",
      "service_fee": 0These notes will be visible to all parties",
      "shippinginternal_notes": 0,
      "tax": 0,
      "additional_expense": 0,
      "discount": 0,
      "promo_code": "10DOLLARSOFF","These notes will be visible only to your office (1937)"
    }
  ]
}


Flash Seats™ Electronic Transfer

Create a Buy Order for Flash Seats tickets to be electronically transferred to a supplied name/email. In this example, a broker named “TEvo POS Test - Main Office (1937)” is buying two tickets for themselves. The Flash Seats will be transferred to the provided email address.

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "

...

shipped_

...

items": [

...

       

...

 {
          "items": [
            {
    

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 "ticket_group_id": 453545038,
       

...

   

...

If the email address to be associated with the delivery has not been created for the Client replace email_address_id with a email_address_attributes object.

...

languagejs
themeRDark
firstline14
linenumberstrue

...

    "quantity": 2,
      

...

becomes

...

languagejs
themeRDark
firstline14
linenumberstrue

...

        "price": 10
            }
       

...

 

...

  ],
          "

...

type": "

...

FlashSeats",
          

...

Flash Seats™ Electronic Transfer

Create a Buy/Sell order for Flash Seats tickets to be electronically transferred to the Client. In this example, a broker named “TEvo POS Test - Main Office (1937)” is selling two tickets to their client, Ned Flanders (167895). The Flash Seats will be transferred to an email address (207924) that was previously created for Ned Flanders.

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": ["ship_to_name": "Jackie Martinoski",
          "email_address_attributes": {
     {       "shipped_itemsaddress": ["jackie@ticketevolution.com"
          }
   {     }
     "items": [ ],
      "payments": [
    {    {
          "ticket_group_idtype": 385269975,"evopay"
        }
     "price": 10],
      "buyer_id": 1937,
      "quantitybuyer_reference_number": 2"123456789",
            }
          ]"external_notes": "These notes will be visible to all parties",
          "type"internal_notes": "FlashSeats",These notes will be visible only to your office   "ship_to_name": "Ned Flanders",(1937)"
    }
  ]
   "email_address_id": 207924,
        }
      ],
      "billing_address_id": 111111,
      "payments}


TM Mobile Entry Electronic Transfer

Create a Buy Order for TM Mobile Entry tickets to be electronically transferred to a supplied name/email. In this example, a broker named “TEvo POS Test - Main Office (1937)” is buying two tickets for themselves. The tickets will be transferred to the provided email address.

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "typeitems": "credit_card", [
           "credit_card_id": 22222
       {
 }       ],       "sellerticket_group_id": 1937453545058,
      "client_id": 167895,       "created_by_ip_addressquantity": "12.34.56.78"2,
      "service_fee": 0,       "shippingprice": 15
0,       "tax": 0,     }
    "additional_expense": 0,      ],
  "discount": 0,       "promo_codetype": "10DOLLARSOFFTMMobile",
          "sellership_referenceto_numbername": "123456789Jackie Martinoski",
          "externalemail_address_notesattributes": {
"These notes will be visible to all parties"     "address": "jackie@ticketevolution.com"
          }
        }
      ],
      "internal_notespayments": "These[
notes will be visible only to your office (1937)"{
    }   ] }

If the email address to which the tickets should be transferred has not been created for Ned Flanders simply replace

...

languagejs
themeRDark
firstline15
linenumberstrue
  "type": "evopay"
        }
     

...

with

...

languagejs
themeRDark
firstline15
linenumberstrue

...

 ],
      "buyer_id": 1937,
      "

...

buyer_

...

reference_

...

number": 

...

"123456789",
      

...

"external_notes": "

...

These notes will be visible to all parties",
   

...

   "internal_notes": "These notes will be visible only to your office (1937)"
    }
  ]
}


TM Mobile Entry

...

delivered via PDF a/k/a “Mobile Screencap” or “Mobile Screenshot”

Currently, these orders can be treated the same as Print at Home tickets (Etickets). See above.


Guest List

Create a Buy Order for Guest List tickets. In this example, a broker named “TEvo POS Test - Main Office (1937)” is

...

buying two tickets

...

for Jackie Martinoski.

Code Block
languagejs
themeRDark
linenumbers

...

{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 385269975,
              "price": 10,
              "quantity": 2
            }
          ],
          "type": "TMMobile",
          "ship_to_name": "Ned Flanders",
          "email_address_id": 207924,
        }
      ],
      "billing_address_id": 111111,
      "payments": [
        {
          "type": "credit_card",
          "credit_card_id": 22222
        }
      ],
      "seller_id": 1937,
      "client_id": 167895,
      "created_by_ip_address": "12.34.56.78",
      "service_fee": 0,
      "shipping": 0,
      "tax": 0,
      "additional_expense": 0,
      "discount": 0,
      "promo_code": "10DOLLARSOFF",
      "seller_reference_number": "123456789",
      "external_notes": "These notes will be visible to all parties",
      "internal_notes": "These notes will be visible only to your office (1937)"
    }
  ]
}

If the email address to which the tickets should be transferred has not been created for Ned Flanders simply replace

Code Block
languagejs
themeRDark
firstline15
linenumberstrue
          "email_address_id": 207924,

with

Code Block
languagejs
themeRDark
firstline15
linenumberstrue
          "email_address_attributes": {
            "address": "nedflanders@example.com"
          }

TM Mobile Entry delivered via PDF a/k/a “Mobile Screencap” or “Mobile Screenshot”

Currently, these orders can be treated the same as Print at Home tickets (Etickets). See above.

Guest List

Create a Buy/Sell order for Guest List tickets. In this example, a broker named “TEvo POS Test - Main Office (1937)” is selling two tickets to their client, Ned Flanders (167895).

{ "orders": [ { "shipped_items": [ { "items": [ { "ticket_group_id": 385269975, "price": 10, "quantity": 2 } ], "type": "GuestList", "ship_to_name": "Ned Flanders", "phone_number_id": 33333 } ],
Code Block
languagejs
themeRDark
linenumberstrue
true
{
  "orders": [
    {
      "billingshipped_address_iditems": 111111,
      "payments": [
        {
          "type": "credit_card",
          "credit_card_id": 22222
  items": [
     }       ],{
      "seller_id": 1937,       "clientticket_group_id": 167895453545048,
      "created_by_ip_address": "12.34.56.78",       "service_feequantity": 02,
      "shipping": 0,       "taxprice": 20
   0,       "additional_expense": 0, }
     "discount": 0,    ],
  "promo_code": "10DOLLARSOFF",       "seller_reference_numbertype": "123456789GuestList",
          "externalship_to_notesname": "TheseJackie notesMartinoski"
will be visible to all parties",       "internal_notes": "These notes will be visible only to your office (1937)"
    }
  ]
}

If the phone number to be associated with the local pick up has not been created for the Client replace phone_number_id with a phone_number_attributes object.

Code Block
languagejs
themeRDark
firstline15
linenumberstrue
}
      ],
      "payments": [
        {
          "phone_number_idtype": 33333

becomes

Code Block
languagejs
themeRDark
firstline15
linenumberstrue
  "evopay"
        }
      ],
 "phone_number_attributes": {    "buyer_id": 1937,
       "extensionbuyer_reference_number": "5123456789",
      "external_notes": "These notes will be visible to "number":all parties"972-468-9750",
      "internal_notes": "These notes will be visible  "is_primary": false
 only to your office (1937)"
    }
  ]
}