NewsMAN API: remarketing.saveOrdersFromXML

Newsman – Knowledge Base

HomeAPIRemarketingremarketing.saveOrdersFromXML

Metoda API Newsman: remarketing.saveOrdersFromXML

Prototip: remarketing.saveOrdersFromXML(list_id, orders_xml)

Descriere: Programează salvarea, din string-ul formatat XML, a până la 5000 comenzi per apel pentru lista care are website-ul asignat. Se vor salva doar comenzile care conțin date valide. Salvarea comenzilor se va face în background.

Metoda HTTP: POST

Endpoint HTTP: /remarketing.saveOrdersFromXML.json

Endpoint XML-RPC: remarketing.saveOrdersFromXML

Tip raspuns: array

Informatii raspuns: string

Parametrii request POST

Variabila	Tip	Descriere
list_id	string\|int	ID-ul listei asociate sitului pentru care se dorește salvarea comenzilor
orders_xml	string	Un string formatat XML care conține una sau mai multe comenzi pentru a fi importate. XML-ul trebuie să conțina un singur element root , și fiecare element individual trebuie să fie un nod sub . Nodurile permise pentru fiecare sunt: order_no sau id_order - id-ul comenzii din site. obligatoriu date_add sau created_at - data la care a fost plasată comanda în format YYYY-MM-DD HH:MM:SS. optional lastname - numele clientului. obligatoriu firstname - prenumele clientului. obligatoriu email - email-ul clientului. obligatoriu phone - telefonul clientului. obligatoriu status - status-ul comenzii. optional discount_code - codul de discount folosit în comandă. optional discount - valoarea de discount a comenzii. optional shipping - costul livrării. Dacă nu se aplică, trebuie valoarea 0. obligatoriu rebates - valoare pentru rabaturi. optional fees - valoarea pentru taxe. Dacă nu se aplică, trebuie valoarea 0. obligatoriu total - totalul comenzii. Este totalul final al comenzii. obligatoriu currency - moneda în care sunt denominate prețurile / valorile. obligatoriu products - Array conținând produsele comenzii. Fiecare element trebuie să fie un array asociativ cu produsele comenzii. Cheile permise sunt: id - id-ul produsului din website. obligatoriu quantity - cantitatea produsului. obligatoriu price - prețul produsului din comandă. obligatoriu variation_code - codul de variantă al produsului. Daca nu se aplică trebuie să fie un string gol (""). obligatoriu

Parametrii raspuns

Parametru	Descriere
array	Array asociativ în care fiecare cheie este id-ul comenzii și valoarea este un array având cheile saved (boolean) și 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);

Exemplu output

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

Erori raspuns

Cod	Mesaj	Descriere
407	Missing required param list_id	Parametrul list_id este obligatoriu
101	Not allowed for list_id = %s	Acces nepermis la list_id
407	Missing required param orders	Parametrul orders este obligatoriu
1507	No valid purchases	Nu a fost trimisă vreo comandă validă
1508	List does not have remarketing enabled	Lista nu are feature-ul de remarketing activat

Exemple de erori

{
    "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
}

Sectiuni

Newsman – Knowledge Base

Sectiuni

Metoda API Newsman: remarketing.saveOrdersFromXML

Prototip: remarketing.saveOrdersFromXML(list_id, orders_xml)

Descriere: Programează salvarea, din string-ul formatat XML, a până la 5000 comenzi per apel pentru lista care are website-ul asignat. Se vor salva doar comenzile care conțin date valide. Salvarea comenzilor se va face în background.

Metoda HTTP: POST

Endpoint HTTP: /remarketing.saveOrdersFromXML.json

Endpoint XML-RPC: remarketing.saveOrdersFromXML

Tip raspuns: array

Informatii raspuns: string

Parametrii request POST

Parametrii raspuns

Exemple request

Exemplu output

Erori raspuns

Exemple de erori