Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Converted FAQs to Expandable FAQs an fix a couple typos

...

Once you've entered the URL into the appropriate field, click on the "Save" button at the bottom of the screen. Your configuration is completedcomplete.

Third Option: Transmit Auto Order Status to URL when auto order changes

...

Code Block
languagegroovy
titleAuto Order Update XML details
collapsetrue
auto_order
  original_order_id
  auto_order_code
  firstname
  lastname
  email
  address
  address2
  city
  state
  zip
  company
  country
  home_phone
  cell_phone
  office_phone
  custom_field_1
  custom_field_2
  custom_field_3
  custom_field_4
  custom_field_5
  custom_field_6
  custom_field_7
  status = active, card declined, cancelled upgrade, cancelled downgrade, cancelled, terminated
  next_attempt
  attempt
  failure_reason
  status
  cancelled_by
  cancelled_dts
  original_items
    item
      item_id
      description
      unit_cost
      quantity
  auto_order_items
    auto_order_item
      original_item_id
      quantity
      frequency_override
      next_shipment
      next_item_id
      no_orders_after
      override_unit_cost
      override_unit_cost_next_x_orders
      percentage_discount
      next_preshipment_notice

 

If you use the second option "Transmit to URL when stage changes" then UltraCart will also send you an XML postback when a refund occurs.  When refunds occur the order can be in multiple stages (SD or CO typically) so you will want to look for the following elements in the XML:

  • subtotal_discount_refunded

  • subtotal_refunded

  • other_refunded

  • tax_refunded

  • shipping_handling_refunded

  • buysafe_refunded

  • total_refunded

  • refund_dts

If a refund has occurred, the elements "total_refunded" and "refund_dts" will always exist.  The other elements mentioned above will exist if that component of the order was refunded.

Frequently Asked Questions

...


Expand
titleWhen the postback occurs does it always pass the full set of customer data including custom fields?

...

There is quite a bit of order information in the XML postback, including customer data and the custom fields 1-7.

...


Expand
titleIs there a way it identifies it self as an auto-order vs an initial order?

...

...

On an order XML postback there is an element for the auto_order information. Inside that element there is a field for auto_order_original_order_id. If that is the same as the order_id in the XML document then this is the original order in the auto order sequence. If it's different then it's a rebill. 


Expand
title

...

Just to clarify for each successful auto-order charge it will go through the main postback URL right? (not the auto-order status change URL)

...

...

Orders go through one URL and auto order status information through another. They can be the same URL if you want to configure it that way and just teach the one script to parse the XML document and then look at the content differently.


Expand
title

...

For the auto-order status change postback, do you have an XML schema for that? or is it the same as the normal postback? is their a particular field that we shouid check for?

...

...

There is not a schema file for this yet, but the easiest thing to do is configure a dummy URL, let the auto order XML postback fire, and then check the log under the XML postback configuration to see a copy of the document it tried to send

...

Refunds

If you use the second option "Transmit to URL when stage changes" then UltraCart will also send you an XML postback when a refund occurs.  When refunds occur the order can be in multiple stages (SD or CO typically) so you will want to look for the following elements in the XML:

  • subtotal_discount_refunded

  • subtotal_refunded

  • other_refunded

  • tax_refunded

  • shipping_handling_refunded

  • buysafe_refunded

  • total_refunded

  • refund_dts

...

.  

...

Log

Since the information sent to your server is critical to your business operation, UltraCart records logs of each transmission. To access the logs
click on the Log button as shown below.

...