Skip to main content

FAQs around Inbound API

How long does it take for data to reflect on the Putler dashboard after pushing it?​

It takes approximately 30-40 minutes for data to reflect on the user account of the Putler dashboard after pushing it to the inbound API.

What should I do if there's an error with my data submission?​

Any incorrect or invalid entries will result in the need to contact support to clean the data. Ensure that all required fields are filled and that the data is accurate.

How should I format the date and time fields?​

The Date field should be formatted as MM/DD/YYYY, and the Time field should be in GMT 24-hour format (HH:MM).

Can I push transactions in CSV format?​

Yes, you can push transactions in CSV format. Ensure the CSV file has the appropriate header fields and follows the sample format provided in the documentation.

Can I push transactions in JSON format?​

Yes, you can push transactions in JSON format. Ensure that the JSON data follows the appropriate structure as described in the documentation.

What is the correct format for sending multiple line items in a shopping cart transaction?​

For an order with multiple line items, create separate transactions for each line item plus one entry for the main order. For example, an order with 3 line items will have 4 entries: one for the main order and one for each line item.

note

Just make sure you're sending the all the entries in single request.

To know more about Shopping Cart Transaction Read here.

How do I handle refunds in the API?​

Each refund transaction should be a new entry with the required field Reference_Txn_ID, which is the transaction ID of the parent transaction being refunded.

Does Inbound API has size limit ?​

When sending CSV files to api.putler.com/inbound, it's best to split your data into smaller chunks for smoother processing.

There is a size limit for the data sent to the Inbound API. The data should not exceed 30 MB.

While there's no strict row limit, typically around 1000-2000 rows per batch works well. This helps to optimize processing speed and avoids overwhelming the system.

info

If you send too much data at once, it might take longer to process. So, breaking it down into smaller batches ensures efficient data handling and faster imports!

Unable to insert data via Inbound API?​

It is possible that something is not right on your end. Please go through the checklist below:

  1. The data you need to pass is an array of transactions (i.e. an array of objects).

Important: Wrap it in an array even if it's one single transaction.

E.g. [ {transaction1}, {transaction2}, {transaction3}, ... ]

  1. Make sure you have the right Content-Type set in the request header.

'Content-Type': 'application/json'

Or try discarding it altogether.

  1. Make sure to pass the JSON data payload in the BODY of the request.

Avoiding passing it as query params.

Pass it as a JSON in the BODY of the request.

  1. Make sure you are sending a POST request to http://api.putler.com/inbound/
note

If you are not using HTTP POST, you can push transactions using action input parameters