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.

...

Create a Buy order for physical tickets that will ship via FedEx. 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": 385270025453545078,
              "quantity": 2,
              "price": 5
            }
          ],
          "type": "FedEx",
          "service_type": "LEAST_EXPENSIVE",
          "signature_type": "INDIRECT",
          "residential": true,
          "ship_to_company_name": "LeftoriumTEvo POS Test - Main Office",
          "ship_to_name": "NedJackie FlandersMartinoski",
          "address_idattributes": {
111111,            "phonestreet_number_idaddress": 33333"9060 East Via Linda",
     }       ],
      "billing"extended_address_id": 111111"Suite 230",
      "payments": [     "locality": "Scottsdale",
  {           "typeregion": "credit_cardAZ",
            "creditpostal_card_idcode": 22222"85258",
        }    "country_code": "US"
 ],        "seller_id": 1937 },
      "client_id": 167895,    "phone_number_attributes": {
            "created_by_ip_addressextension": "12.34.56.785",
      "service_fee": 0,
      "shippingnumber": 0"972-468-9750",
      "tax": 0,
      "additionalis_expenseprimary": false
0,         "discount": 0, }
      "promo_code": "10DOLLARSOFF", }
     "seller_reference_number": "123456789" ],
      "external_notespayments": "These notes will be visible to all parties",[
        {
          "internal_notestype": "Theseevopay"
notes will be visible only to your office (1937)"}
    }   ]
}

If the address to which the tickets should be shipped has not been created for the Client replace address_id with an address_attributes object.

Code Block
languagejs
themeRDark
firstline19
linenumberstrue
   ],
      "addressbuyer_id": 111111,

becomes

Code Block
languagejs
themeRDark
firstline19
linenumberstrue
   1937,
      "buyer_reference_number": "123456789",
      "addressexternal_attributesnotes": {"These notes will be visible to all parties",
      "streetinternal_addressnotes": "7721These Eastnotes Graywill Road",be visible only to your office (1937)"
      "extended_address": "Suite 102",
            "locality": "Scottsdale",
            "region": "AZ",
            "postal_code": "85260",
            "country_code": "US"
          },

All FedEx shipments require a phone number of the recipient. If the phone number to be associated with the shipment has not been created for the Client replace phone_number_id with a phone_number_attributes object.

Code Block
languagejs
themeRDark
firstline20
linenumberstrue
          "phone_number_id": 33333

becomes

Code Block
languagejs
themeRDark
firstline20
linenumberstrue
          "phone_number_attributes": {
            "extension": "5",
            "number": "972-468-9750",
            "is_primary": false
          }

Physical Tickets with Local Pick Up

Create a Buy/Sell order for physical tickets when it is too late to ship and the tickets must be picked up locally by the consumer. In this example, a broker named “TEvo POS Test - Main Office (1937)” is selling two tickets to their client, Ned Flanders (167895). 

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 385270025,
              "quantity": 2,
              "price": 5
            }
          ],
          "type": "LocalPickup",
          "ship_to_name": "Ned Flanders",
   }
  ]
}


Physical Tickets with Local Pick Up

Create a Buy/Sell order for physical tickets when it is too late to ship and the tickets must be picked up locally by the consumer. In this example, a broker named “TEvo POS Test - Main Office (1937)” is selling two tickets to their client, Ned Flanders (167895). 

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "notes": "Please contact Ned to arrange when and where to pick up his ticket.",
shipped_items": [
        {
          "phone_number_iditems": 33333[
        }    {
  ],       "billing_address_id": 111111,       "paymentsticket_group_id": [453545078,
        {      "quantity": 2,
   "type": "credit_card",           "credit_card_idprice": 5
  22222          }
      ],    ],
  "seller_id": 1937,       "client_idtype": 167895"LocalPickup",
          "createdship_byto_ip_addressname": "12.34.56.78Jackie Martinoski",
      "service_fee    "notes": 0,"Please contact Jackie to arrange when and "shipping": 0,
   where to pick up these tickets.",
  "tax": 0,       "additionalphone_number_expenseattributes": 0,{
      "discount": 0,       "promo_codeextension": "10DOLLARSOFF5",
      "seller_reference_number": "123456789",       "external_notesnumber": "These notes will be visible to all parties",972-468-9750",
            "internalis_notesprimary": "Thesefalse
 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
firstline16
linenumberstrue
     }
      ],
      "phone_number_idpayments": 33333

becomes

Code Block
languagejs
themeRDark
firstline16
linenumberstrue
 [
        {
          "phone_number_attributes": {type": "evopay"
        }
      ],
      "extensionbuyer_id": "5"1937,
      "buyer_reference_number": "123456789",
      "numberexternal_notes": "972-468-9750",
     These notes will be visible to all parties",
      "isinternal_primarynotes": false
     "These notes will be visible only to your office (1937)"
    }
  ]
}

Print at Home Tickets (Etickets)

Create a Buy/Sell 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 two tickets to their client, Ned Flanders (167895). 

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 385270025,
              "quantity": 2,
              "price": 5
            }
          ],
          "type": "Eticket",
          "email_address_id": 333333
        }
      ],
      "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)"
    }
  ]
}

...

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": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 385269975,
              "price": 10,
              "quantity": 2
            }
          ],
          "type": "FlashSeats",
          "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)"
    }
  ]
}


...

Create a Buy/Sell order for TM Mobile Entry 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 tickets will be transferred to an email address (207924) that was previously created for Ned Flanders.

Code Block
languagejs
themeRDark
linenumberstrue
{
  "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)"
    }
  ]
}


...

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).

Code Block
languagejs
themeRDark
linenumberstrue
{
  "orders": [
    {
      "shipped_items": [
        {
          "items": [
            {
              "ticket_group_id": 385269975,
              "price": 10,
              "quantity": 2
            }
          ],
          "type": "GuestList",
          "ship_to_name": "Ned Flanders",
          "phone_number_id": 33333
        }
      ],
      "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 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
          "phone_number_id": 33333

becomes

Code Block
languagejs
themeRDark
firstline15
linenumberstrue
          "phone_number_attributes": {
            "extension": "5",
            "number": "972-468-9750",
            "is_primary": false
          }