NewsMAN API: remarketing.saveOrdersFromXML

Sections

Newsman – Knowledge Base

HomeAPIRemarketingremarketing.saveOrdersFromXML

Newsman Api Method: remarketing.saveOrdersFromXML

Prototype: remarketing.saveOrdersFromXML(list_id, orders_xml)

Description: Schedules the saving, from the XML-formatted string, of multiple orders (up to 5000) for the list that are linked to the website. Only purchases with validated data will be saved. Saving the purchases will be done in the background.

HTTP method: POST

Endpoint HTTP: /remarketing.saveOrdersFromXML.json

Endpoint XML-RPC: remarketing.saveOrdersFromXML

Return type: array

Return info: string

Request parameters POST

Variable	Type	Description
list_id	string\|int	The ID of the list linked to the website for which to save the orders
orders_xml	string	An XML-formatted string containing one or more customer orders to be imported in bulk. The XML must contain a single root element , and each individual element must be a direct child of . Allowed nodes for each are: order_no or id_order - the order id from the website. required date_add or created_at - the date the order was placed in YYYY-MM-DD HH:MM:SS format. optional lastname - the buyer's last name. required firstname - the buyer's first name. required email - the buyer's email address. required phone - the buyer's phone number. required status - the status of the order. optional discount_code - the discount code used when placing the order, if any. optional discount - the amount / value by which the total amount was reduced, if any. optional shipping - value / amount paid for the shipping (shipping fee). If there is no shipping charge, send value 0. required rebates - value/amount paid for the rebates. optional fees - value/amount paid for the fees. If there is no fees charge, send value 0. required total or total_paid - amount / total amount of payment for the order sent. Note that this the total amount the buyer actually pays, the amount obtained after applying any discount and/or shipping fee. required currency - the currency in which the sales prices of products are denominated. required products - All products should be under a child node of . Allowed nodes for each product are: id - the product id from the website. required quantity - the quantity ordered for the product. required price - the sale price of the product. required variation_code - variation code of the ordered product. If the product does not have variation will send a empty string (no character string ""). required

Response parameters

Parameter	Description
array	Associative array with each key being the order id and the value being an associative array with the keys saved (boolean) and errors (array).

// https://github.com/Newsman/newsman-api-php

<?php
 
//client can de downloaded from https://github.com/Newsman/newsman-api-php
require_once("Newsman/Client.php");
 
// you can get your API KEY, your newsman_user_id and list_id from My account -> API
$newsman_user_id = "your-username";
$api_key = "your-api-key";
$list_id = "your-list-id";
 
$orders_xml = "<?xml version='1.0'?>
<orders>
<order>
<id_order>32189883</id_order>
<date_add>2025-10-15 17:45:14</date_add>
<total>75.42</total>
<status>shipped</status>
<email>john@doe.com</email>
<firstname></firstname>
<lastname>Some Company</lastname>
<phone>747123328</phone>
<fees>10.0524</fees>
<shipping>17.5</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>332</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
<product>
<id_product>331</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
<product>
<id_product>330</id_product>
<quantity>1</quantity>
<price>10.85</price>
<variation_code></variation_code>
</product>
<product>
<id_product>328</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
</products>
</order>
<order>
<id_order>40236375</id_order>
<date_add>2025-10-15 17:44:12</date_add>
<total>18200</total>
<status>delivered</status>
<email>john2@doe.com</email>
<firstname></firstname>
<lastname>Acme S.R.L</lastname>
<phone>747123327</phone>
<fees>3158.6777</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>352</id_product>
<quantity>1</quantity>
<price>18200</price>
<variation_code>100000003</variation_code>
</product>
</products>
</order>
<order>
<id_order>51294657</id_order>
<date_add>2025-10-15 17:48:25</date_add>
<total>16500</total>
<status>delivered</status>
<email>john3@doe.com</email>
<firstname>CC5H</firstname>
<lastname></lastname>
<phone>747444789</phone>
<fees>2863.6364</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>352</id_product>
<quantity>1</quantity>
<price>16500</price>
<variation_code>100000001</variation_code>
</product>
</products>
</order>
<order>
<id_order>60908402</id_order>
<date_add>2025-10-15 17:46:15</date_add>
<total>16.88</total>
<status>in_process</status>
<email>john4@doe.com</email>
<firstname>cli</firstname>
<lastname>nm</lastname>
<phone>747444789</phone>
<fees>2.9296</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>321</id_product>
<quantity>1</quantity>
<price>9.64</price>
<variation_code></variation_code>
</product>
<product>
<id_product>320</id_product>
<quantity>1</quantity>
<price>7.24</price>
<variation_code></variation_code>
</product>
</products>
</order>
<order>
<id_order>87961212</id_order>
<date_add>2025-10-15 17:40:31</date_add>
<total>34.99</total>
<status>awaiting</status>
<email>john5@doe.com</email>
<firstname>Cust4</firstname>
<lastname>C4</lastname>
<phone>747444789</phone>
<fees>6.0727</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>350</id_product>
<quantity>1</quantity>
<price>16.9</price>
<variation_code></variation_code>
</product>
<product>
<id_product>349</id_product>
<quantity>1</quantity>
<price>12.06</price>
<variation_code></variation_code>
</product>
<product>
<id_product>348</id_product>
<quantity>1</quantity>
<price>6.03</price>
<variation_code></variation_code>
</product>
</products>
</order>
</orders>";
 
try {
	$client = new Newsman_Client($newsman_user_id, $api_key);
	$ret = $client->remarketing->saveOrdersFromXML($list_id, $orders_xml);
} catch (Exception $e) {
	//do something with the error, eg: log $e->getMessage()
}
 
return $ret;
 
?>

# https://github.com/Newsman/newsman-api-python

import newsman
 
user_id = "your_user_id"
api_key = "your_api_key"
list_id = "your-list-id"
 
orders_xml = """<?xml version='1.0'?>
<orders>
<order>
<id_order>32189883</id_order>
<date_add>2025-10-15 17:45:14</date_add>
<total>75.42</total>
<status>shipped</status>
<email>john@doe.com</email>
<firstname></firstname>
<lastname>Some Company</lastname>
<phone>747123328</phone>
<fees>10.0524</fees>
<shipping>17.5</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>332</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
<product>
<id_product>331</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
<product>
<id_product>330</id_product>
<quantity>1</quantity>
<price>10.85</price>
<variation_code></variation_code>
</product>
<product>
<id_product>328</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
</products>
</order>
<order>
<id_order>40236375</id_order>
<date_add>2025-10-15 17:44:12</date_add>
<total>18200</total>
<status>delivered</status>
<email>john2@doe.com</email>
<firstname></firstname>
<lastname>Acme S.R.L</lastname>
<phone>747123327</phone>
<fees>3158.6777</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>352</id_product>
<quantity>1</quantity>
<price>18200</price>
<variation_code>100000003</variation_code>
</product>
</products>
</order>
<order>
<id_order>51294657</id_order>
<date_add>2025-10-15 17:48:25</date_add>
<total>16500</total>
<status>delivered</status>
<email>john3@doe.com</email>
<firstname>CC5H</firstname>
<lastname></lastname>
<phone>747444789</phone>
<fees>2863.6364</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>352</id_product>
<quantity>1</quantity>
<price>16500</price>
<variation_code>100000001</variation_code>
</product>
</products>
</order>
<order>
<id_order>60908402</id_order>
<date_add>2025-10-15 17:46:15</date_add>
<total>16.88</total>
<status>in_process</status>
<email>john4@doe.com</email>
<firstname>cli</firstname>
<lastname>nm</lastname>
<phone>747444789</phone>
<fees>2.9296</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>321</id_product>
<quantity>1</quantity>
<price>9.64</price>
<variation_code></variation_code>
</product>
<product>
<id_product>320</id_product>
<quantity>1</quantity>
<price>7.24</price>
<variation_code></variation_code>
</product>
</products>
</order>
<order>
<id_order>87961212</id_order>
<date_add>2025-10-15 17:40:31</date_add>
<total>34.99</total>
<status>awaiting</status>
<email>john5@doe.com</email>
<firstname>Cust4</firstname>
<lastname>C4</lastname>
<phone>747444789</phone>
<fees>6.0727</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>350</id_product>
<quantity>1</quantity>
<price>16.9</price>
<variation_code></variation_code>
</product>
<product>
<id_product>349</id_product>
<quantity>1</quantity>
<price>12.06</price>
<variation_code></variation_code>
</product>
<product>
<id_product>348</id_product>
<quantity>1</quantity>
<price>6.03</price>
<variation_code></variation_code>
</product>
</products>
</order>
</orders>"""
 
client = newsman.Newsman(user_id, api_key)
client.remarketing.saveOrdersFromXML(list_id, orders_xml)

// https://github.com/Newsman/newsman-api-dotnet

RESTClient client = new RESTClient("your_user_id", "your_api_key");
 
var _params = new NameValueCollection();
 
// Required parameter
_params["list_id"] = "your-list-id";
 
// orders xml
var orders_xml = @"<?xml version='1.0'?>
<orders>
<order>
<id_order>32189883</id_order>
<date_add>2025-10-15 17:45:14</date_add>
<total>75.42</total>
<status>shipped</status>
<email>john@doe.com</email>
<firstname></firstname>
<lastname>Some Company</lastname>
<phone>747123328</phone>
<fees>10.0524</fees>
<shipping>17.5</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>332</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
<product>
<id_product>331</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
<product>
<id_product>330</id_product>
<quantity>1</quantity>
<price>10.85</price>
<variation_code></variation_code>
</product>
<product>
<id_product>328</id_product>
<quantity>1</quantity>
<price>15.69</price>
<variation_code></variation_code>
</product>
</products>
</order>
<order>
<id_order>40236375</id_order>
<date_add>2025-10-15 17:44:12</date_add>
<total>18200</total>
<status>delivered</status>
<email>john2@doe.com</email>
<firstname></firstname>
<lastname>Acme S.R.L</lastname>
<phone>747123327</phone>
<fees>3158.6777</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>352</id_product>
<quantity>1</quantity>
<price>18200</price>
<variation_code>100000003</variation_code>
</product>
</products>
</order>
<order>
<id_order>51294657</id_order>
<date_add>2025-10-15 17:48:25</date_add>
<total>16500</total>
<status>delivered</status>
<email>john3@doe.com</email>
<firstname>CC5H</firstname>
<lastname></lastname>
<phone>747444789</phone>
<fees>2863.6364</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>352</id_product>
<quantity>1</quantity>
<price>16500</price>
<variation_code>100000001</variation_code>
</product>
</products>
</order>
<order>
<id_order>60908402</id_order>
<date_add>2025-10-15 17:46:15</date_add>
<total>16.88</total>
<status>in_process</status>
<email>john4@doe.com</email>
<firstname>cli</firstname>
<lastname>nm</lastname>
<phone>747444789</phone>
<fees>2.9296</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>321</id_product>
<quantity>1</quantity>
<price>9.64</price>
<variation_code></variation_code>
</product>
<product>
<id_product>320</id_product>
<quantity>1</quantity>
<price>7.24</price>
<variation_code></variation_code>
</product>
</products>
</order>
<order>
<id_order>87961212</id_order>
<date_add>2025-10-15 17:40:31</date_add>
<total>34.99</total>
<status>awaiting</status>
<email>john5@doe.com</email>
<firstname>Cust4</firstname>
<lastname>C4</lastname>
<phone>747444789</phone>
<fees>6.0727</fees>
<shipping>0</shipping>
<currency>RON</currency>
<products>
<product>
<id_product>350</id_product>
<quantity>1</quantity>
<price>16.9</price>
<variation_code></variation_code>
</product>
<product>
<id_product>349</id_product>
<quantity>1</quantity>
<price>12.06</price>
<variation_code></variation_code>
</product>
<product>
<id_product>348</id_product>
<quantity>1</quantity>
<price>6.03</price>
<variation_code></variation_code>
</product>
</products>
</order>
</orders>";
 
_params["orders_xml"] = orders_xml;
 
// --- Call remarketing.saveOrder ---
var response = client.CallMethod("remarketing", "saveOrdersFromXML", _params);

Output example

{
    "125811": {
        "saved": 1,
        "errors": []
    },
    "125812": {
        "saved": 0,
        "errors": [
            "missing products"
        ]
    }
}

Response Errors

Code	Message	Description
407	Missing required param list_id	list_id param is required
101	Not allowed for list_id = %s	Invalid access to list_id
407	Missing required param orders	orders param is required
1507	No valid purchases	No valid purchases sent
1508	List does not have remarketing enabled	List does not have remarketing enabled

Error examples

{
    "err": true,
    "message": "Missing required param list_id",
    "code": 407
}

{
    "err": true,
    "message": "Not allowed for list_id %s",
    "code": 101
}

{
    "err": true,
    "message": "Missing required param orders",
    "code": 407
}

{
    "err": true,
    "message": "No valid purchases sent",
    "code": 1507
}