API 1.0

I. Використовується

В основному для самописних інтернет-магазинів.
 

II. Налаштування


Для налаштування API 1.0, потрібно:
   1. Згенерувати ключ доступу
   2. Дати доступ до об'єктів сервісу
Для цього треба зайти: Верхнє меню - Сервіс - API 1.0
 
Акты инвентаризации новый


І встановити перемикачі для тих об'єктів, для яких Ви хотіли б здійснювати Експорт / Імпорт. Зауважимо, що для довідника «Товари», є під-пункти (повне найменування, опис, ...), якщо Ви їх не використовуєте, то зніміть з них галочки, інакше на вивантаження витратеться багато часу.
 

III. Export


Дані Ви будете отримувати у JSON-форматі.


1. Довідник «Товари». 
Для отримання даних з довідника «Товари», Вам потрібно сформувати запит сервісу в такому форматі:
http://sklad.uchetoblako.ru/API/Api10.ashx?Key=XXX&pID=ExportDirNomen&DirNomenGroup=78
параметри:
Key – од ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Товар» (ExportDirNomen)
DirNomenGroup – Група товару, якщо потрібно вивантажувати дані по Групам. Можна вказувати і номер групи і найменування групи. Номер групи можна отримати при редагуванні групи:
Акты инвентаризации новый
 

Ми рекомендуємо використовувати саме номер групи, а не найменування. Якщо, потрібно експортувати весь довідник, то цей параметр взагалі не вказуєте.
Дані Ви отримаєте в такому форматі:

 

{'sucess':true, 'total':363, 'ExportDirNomen': [
{
"DirNomenID":"2",
"DirNomenGroupID":"1",
"DirNomenGroupName":"Група-1",
"DirNomenName":"Товар-1",
"DirNomenNameFull":"Товар-1":"1",
"DirUnitMeasureName":"шт",
"DirNomenArticle":"123456",
"DirNomenManufacturer":"",
"DirNomenManufacturerCode":"",
"DirCountryName":"",
"DirNomenNumberCustomsDeclaration":"",
"DirNomenMinimumBalance":"3",
"DirNomenDisc":"",
"DirNomenDiscFull":"",
"DirNomenInventoryNumber":"",
"DirVatName":"0%",
"DirCurrencyName":"Українська гривня",
"PriceVAT":"67.6",
"PriceRetailVAT":"95",
"PriceWholesaleVAT":"92.18",
"ImageLink":""
},
{
"DirNomenID":"3",
"DirNomenGroupID":"1",
"DirNomenGroupName":"Група-1",
"DirNomenName":"Товар-2",
"DirNomenNameFull":"Товар-2",
"DirUnitMeasureID":"1",
"DirUnitMeasureName":"шт",
"DirNomenArticle":"45678",
"DirNomenTypeID":"1",
"DirNomenManufacturer":"",
"DirNomenManufacturerCode":"",
"DirCountryName":"",
"DirNomenNumberCustomsDeclaration":"",
"DirNomenMinimumBalance":"1",
"DirNomenDisc":"",
"DirNomenDiscFull":"",
"DirNomenInventoryNumber":"",
"DirVatName":"0%",
"DirCurrencyName":"Українська гривня",
"PriceVAT":"69.75",
"PriceRetailVAT":"97",
"PriceWholesaleVAT":"95.11",
"ImageLink":""
}
]}

 
У прикладі всього 2-а товару, з кодами: DirNomenID=2 и DirNomenID=3

Програмний код на мові програмування .NET C # буде виглядати так:

 
//Строка соединения
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметры
string myParameters = "Key=XXX&pID=ExportDirNomen&DirNomenGroup=1";
using (WebClient wc = new WebClient())
{
   wc.Encoding = System.Text.Encoding.UTF8;
   wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
   Label1.Text = wc.UploadString(URI, myParameters);
}


 
 2. Довідник «Контрагенти».
Запит:
http://sklad.uchetoblako.ru /API/Api10.ashx?Key= XXX
&pID=ExportDirContractor&DirContractoGroup=3
параметри:
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Контрагенти» (ExportDirContractor)
ExportDirContractor – Група контрагента, якщо потрібно вивантажувати дані по Групам. Можна вказувати і номер групи і найменування групи. Номер групи можна отримати при редагуванні групи, аналогічно, як з Товаром. Ми рекомендуємо використовувати саме номер групи, а не найменування. Якщо, потрібно експортувати весь довідник, то цей параметр взагалі не вказуєте.
Дані Ви отримаєте в такому форматі:

 

{'sucess':true, 'total':2, 'ExportDirContractor': [
{
"DirContractorID":"1",
"DirContractorGroupID":"1",
"DirContractorGroupName":"Поставщики",
"DirContractorTypeID":"2",
"DirContractor2TypeID":"2",

"DirContractorTypeName":"Физическое лицо",
"DirContractorName":"Контрагент-1",
"DirContractorAddress":"",
"DirContractorPhone":"123456789",
"DirContractorFax":"",
"DirContractorEmail":"",
"DirContractorWWW":"",
"DirContractorDiscount":"0",
"DirVatName":"0%",
"DirVatValue":"0",
"DirContractorLegalName":"Контрагент-1",
"DirContractorLegalAddress":"",
"DirContractorLegalTIN":"",
"DirContractorLegalRNNBO":"",
"DirContractorLegalCAT":"",
"DirContractorLegalBIN":"",
"DirContractorLegalOGRNIP":"",
"DirContractorLegalCertificateNumber":"",
"DirContractorLegalCertificateDate":"2016-04-01 00:00:00",
"DirContractorLegalPasSeries":"",
"DirContractorLegalPasNumber":"",
"DirContractorLegalPasCode":"",
"DirContractorLegalPasIssued":"",
"DirContractorLegalPasDate":"1992-01-01 00:00:00",
"DirContractorDesc":"",
"ImageLink":""
},
{
"DirContractorID":"2",
"DirContractorGroupID":"1",
"DirContractorGroupName":"Поставщики",
"DirContractorTypeID":"2",
"DirContractor2TypeID":"2",

"DirContractorTypeName":"Физическое лицо ",
"DirContractorName":" Контрагент-1",
"DirContractorAddress":"",
"DirContractorPhone":"",
"DirContractorFax":"",
"DirContractorEmail":"",
"DirContractorWWW":"",
"DirContractorDiscount":"0",
"DirVatName":"0%",
"DirVatValue":"0",
"DirContractorLegalName":" Контрагент-1",
"DirContractorLegalAddress":"",
"DirContractorLegalTIN":"",
"DirContractorLegalRNNBO":"",
"DirContractorLegalCAT":"",
"DirContractorLegalBIN":"",
"DirContractorLegalOGRNIP":"",
"DirContractorLegalCertificateNumber":"",
"DirContractorLegalCertificateDate":"2016-04-01 00:00:00",
"DirContractorLegalPasSeries":"",
"DirContractorLegalPasNumber":"",
"DirContractorLegalPasCode":"",
"DirContractorLegalPasIssued":"",
"DirContractorLegalPasDate":"1999-01-01 00:00:00",
"DirContractorDesc":"",
"ImageLink":""
}
]}

 
У прикладі всього 2-а контрагента, з кодами: DirContractorID =1 и DirContractorID =2

Програмний код на мові програмування .NET C # буде виглядати так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметри
string myParameters = "Key=XXX&pID=ExportDirContractor&DirContractoGroup=4";
using (WebClient wc = new WebClient())
{
   wc.Encoding = System.Text.Encoding.UTF8;
   wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
   Label1.Text = wc.UploadString(URI, myParameters);
}
 
3. Довідник «Залишки».
Запит:
http://sklad.uchetoblako.ru /API/Api10.ashx?Key= XXX&pID=ExportRemnants&DirWarehouse=1
параметри:
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Залишки» (ExportRemnants)
DirWarehouse – Склад, обов'язковий параметр і вказувати потрібно номер складу.
Org – Організація, необов'язковий параметр і вказувати потрібно номер організації.

Акты инвентаризации новый

Дані Ви отримаєте в такому форматі:
 
{'sucess':true, 'total':33, 'ExportRemnants': [
{
"DirNomenID":"1",
"DirNomenName":"Товар-1",
"DirWarehouseID":"1",
"DirWarehouseName":"Склад-1",
" Count ":"3"
},
{
"DirNomenID":"2",
"DirNomenName":"Товар-2",
"DirWarehouseID":"1",
"DirWarehouseName":"Склад-1",
"Quantity":"2"
}
]}

 
У прикладі всього 2-а товару, з кодами: DirNomenID = 2 і DirNomenID = 3 із залишками 3 та 5 штук/кг відповідно.

Програмний код на мові програмування .NET C # буде виглядати так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметри
string myParameters = "Key=XXX&pID=ExportRemnants&DirWarehouse=1";
using (WebClient wc = new WebClient())
{
    wc.Encoding = System.Text.Encoding.UTF8;
    wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
    Label2.Text = wc.UploadString(URI, myParameters);
}

 

 

IV. Import

Дані потрібно відправляти в JSON-форматі.
У всіх випадках при імпорті для передачі колекції Товару/Контрагентів/Специфікації на сервер Вам потрібно сформувати JSON-масив, що складається з полів/значень товару і передати його у вигляді параметра, а так само, ще декілька додаткових параметрів.

 

1. Довідник «Товари».  
параметри:
DirNomenCollection - JSON-масив має вигляд:

 

[
{
'DirNomenID':'1',
'DirNomenGroupID':'3',
'DirNomenGroupName':'Група-1',
'DirNomenName':'Товар-1',
'DirNomenNameFull':'Товар-1',
'DirUnitMeasureID':'1',
'DirUnitMeasureName':'шт',
'DirNomenArticle':'12345',
'DirNomenTypeID':'1',
'DirNomenManufacturer':'',
'DirNomenManufacturerCode':'',
'DirCountryName':'',
'DirNomenNumberCustomsDeclaration':'',
'DirNomenMinimumBalance':'0',
'DirNomenDisc':'',
'DirNomenDiscFull':'',
'DirNomenInventoryNumber':'',
'DirVatName':'0',
'DirCurrencyName':'Українська гривня',
'PriceVAT':'59.25',
'PriceRetailVAT':'129.99',
'PriceWholesaleVAT':'119.99',
'ImageLink':''
},
{
'DirNomenID':'2',
'DirNomenGroupID':'3',
'DirNomenGroupName':'Група-1',
'DirNomenName':'Товар-2',
'DirNomenNameFull':'Товар-2',
'DirUnitMeasureID':'1',
'DirUnitMeasureName':'шт',
'DirNomenArticle':'98765',
'DirNomenTypeID':'1',
'DirNomenManufacturer':'',
'DirNomenManufacturerCode':'',
'DirCountryName':'',
'DirNomenNumberCustomsDeclaration':'',
'DirNomenMinimumBalance':'0',
'DirNomenDisc':'',
'DirNomenDiscFull':'',
'DirNomenInventoryNumber':'',
'DirVatName':'0',
'DirCurrencyName':'Українська гривня',
'PriceVAT':'2587.5',
'PriceRetailVAT':'4999.99',
'PriceWholesaleVAT':'4899.99',
'ImageLink':''
},
]

 
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Товар» (ImportDirNomen)
NotStopProcess – Продовжити далі, навіть якщо є помилки і приймає значення: false, true
MatchName – Якщо Найменування збігаються, то не створювати нову позицію, а перезаписати її (UPDATE) і приймає значення: false, true
MatchArticle – Если Артикул совпадает, то не создавать новую позицию, а перезаписать её (UPDATE) и принимает значения: false, true
 
Программный код на языке программирования .NET C# будет выглядеть так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметри
string DirNomenCollection =  "DirNomenCollection[

{
'DirNomenID':'1',
'DirNomenGroupID':'3',
'DirNomenGroupName':'Група-1',
'DirNomenName':'Товар-1',
'DirNomenNameFull':'Товар-1',
'DirUnitMeasureID':'1',
'DirUnitMeasureName':'шт',
'DirNomenArticle':'12345',
'DirNomenTypeID':'1',
'DirNomenManufacturer':'',
'DirNomenManufacturerCode':'',
'DirCountryName':'',
'DirNomenNumberCustomsDeclaration':'',
'DirNomenMinimumBalance':'0',
'DirNomenDisc':'',
'DirNomenDiscFull':'',
'DirNomenInventoryNumber':'',
'DirVatName':'0',
'DirCurrencyName':'Українська гривня',
'PriceVAT':'59.25',
'PriceRetailVAT':'129.99',
'PriceWholesaleVAT':'119.99',
'ImageLink':''
},
{
'DirNomenID':'2',
'DirNomenGroupID':'3',
'DirNomenGroupName':'Група-1',
'DirNomenName':'Товар-2',
'DirNomenNameFull':'Товар-2',
'DirUnitMeasureID':'1',
'DirUnitMeasureName':'шт',
'DirNomenArticle':'98765',
'DirNomenTypeID':'1',
'DirNomenManufacturer':'',
'DirNomenManufacturerCode':'',
'DirCountryName':'',
'DirNomenNumberCustomsDeclaration':'',
'DirNomenMinimumBalance':'0',
'DirNomenDisc':'',
'DirNomenDiscFull':'',
'DirNomenInventoryNumber':'',
'DirVatName':'0%',
'DirCurrencyName':'Українська гривня',
'PriceVAT':'2587.5',
'PriceRetailVAT':'4999.99',
'PriceWholesaleVAT':'4899.99',
'ImageLink':''
}
]";

 
string myParameters = "Key=XXX&pID=ImportDirNomen&

NotStopProcess=false&MatchName=false&MatchArticle=true&" + DirNomenCollection;


using (WebClient wc = new WebClient())
{
    wc.Encoding = System.Text.Encoding.UTF8;
    wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
    Label1.Text = wc.UploadString(URI, "POST", myParameters);
}

 
Відповідь сервера, після завершення операції імпорту буде такою:
{'success':true, 'data': {'CountInsert':'0','CountUpdate':'2','CountIgnore':'0'}}
Де параметри:
 - CountInsert – нових записів
 - CountUpdate – оновлено вже існуючих записів
 - CountIgnore – помилок


 
 2. Довідник «Контрагенти». 

параметри:
DirContractorCollection - JSON-масив має вигляд:
[
{
'DirContractorID':'1',
'DirContractorGroupID':'1',
'DirContractorGroupName':'Поставщики',
'DirContractorTypeID':'2',
'DirContractor2TypeID':'2',

'DirContractorTypeName':'Физическое лицо',
'DirContractorName':'Контрагент-1',
'DirContractorAddress':'',
'DirContractorPhone':'123456789',
'DirContractorFax':'',
'DirContractorEmail':'',
'DirContractorWWW':'',
'DirContractorDiscount':'0',
'DirVatValue':'0',
'DirContractorLegalName':'Контрагент-1',
'DirContractorLegalAddress':'',
'DirContractorLegalTIN':'',
'DirContractorLegalRNNBO':'',
'DirContractorLegalCAT':'',
'DirContractorLegalBIN':'',
'DirContractorLegalOGRNIP':'',
'DirContractorLegalCertificateNumber':'',
'DirContractorLegalCertificateDate':'2016-04-01 00:00:00',
'DirContractorLegalPasSeries':'',
'DirContractorLegalPasNumber':'',
'DirContractorLegalPasCode':'',
'DirContractorLegalPasIssued':'',
'DirContractorLegalPasDate':'1988-01-01 00:00:00',
'DirContractorDesc':'',
'ImageLink':''
},
{
'DirContractorID':'2',
'DirContractorGroupID':'1',
'DirContractorGroupName':'Поставщики',
'DirContractorTypeID':'2',
'DirContractor2TypeID':'2',

'DirContractorTypeName':'Физическое лицо',
'DirContractorName':'Контрагент-2',
'DirContractorAddress':'',
'DirContractorPhone':'987654321',
'DirContractorFax':'',
'DirContractorEmail':'',
'DirContractorWWW':'',
'DirContractorDiscount':'0',
'DirVatValue':'0',
'DirContractorLegalName':'Контрагент-2',
'DirContractorLegalAddress':'',
'DirContractorLegalTIN':'',
'DirContractorLegalRNNBO':'',
'DirContractorLegalCAT':'',
'DirContractorLegalBIN':'',
'DirContractorLegalOGRNIP':'',
'DirContractorLegalCertificateNumber':'',
'DirContractorLegalCertificateDate':'2016-04-01 00:00:00',
'DirContractorLegalPasSeries':'',
'DirContractorLegalPasNumber':'',
'DirContractorLegalPasCode':'',
'DirContractorLegalPasIssued':'',
'DirContractorLegalPasDate':'1994-01-01 00:00:00',
'DirContractorDesc':'',
'ImageLink':''
}
]

 
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Контрагент» (ImportDirContractor)
NotStopProcess – Продовжити далі, навіть якщо є помилки і приймає значення: false, true
MatchName – Якщо Найменування збігаються, то не створювати нову позицію, а перезаписати її (UPDATE) і приймає значення: false, true
MatchTIN_CAT_BIN – Якщо всі значення ІПН, КПП і свідоцтво про Державну збігається, то не створювати нову позицію, а перезаписати її (UPDATE)
 
Програмний код на мові програмування .NET C # буде виглядати так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru";
//Параметри
string DirContractorCollection =
"DirContractorCollection=

 [
{
'DirContractorID':'1',
'DirContractorGroupID':'1',
'DirContractorGroupName':'Поставщики',
'DirContractorTypeID':'2',
'DirContractor2TypeID':'2',

'DirContractorTypeName':'Физическое лицо',
'DirContractorName':'Контрагент-1',
'DirContractorAddress':'',
'DirContractorPhone':'123456789',
'DirContractorFax':'',
'DirContractorEmail':'',
'DirContractorWWW':'',
'DirContractorDiscount':'0',
'DirVatValue':'0',
'DirContractorLegalName':'Контрагент-1',
'DirContractorLegalAddress':'',
'DirContractorLegalTIN':'',
'DirContractorLegalRNNBO':'',
'DirContractorLegalCAT':'',
'DirContractorLegalBIN':'',
'DirContractorLegalOGRNIP':'',
'DirContractorLegalCertificateNumber':'',
'DirContractorLegalCertificateDate':'2016-04-01 00:00:00',
'DirContractorLegalPasSeries':'',
'DirContractorLegalPasNumber':'',
'DirContractorLegalPasCode':'',
'DirContractorLegalPasIssued':'',
'DirContractorLegalPasDate':'1988-01-01 00:00:00',
'DirContractorDesc':'',
'ImageLink':''
},
{
'DirContractorID':'2',
'DirContractorGroupID':'1',
'DirContractorGroupName':'Поставщики',
'DirContractorTypeID':'2',
'DirContractor2TypeID':'2',

'DirContractorTypeName':'Физическое лицо',
'DirContractorName':'Контрагент-2',
'DirContractorAddress':'',
'DirContractorPhone':'987654321',
'DirContractorFax':'',
'DirContractorEmail':'',
'DirContractorWWW':'',
'DirContractorDiscount':'0',
'DirVatValue':'0',
'DirContractorLegalName':'Контрагент-2',
'DirContractorLegalAddress':'',
'DirContractorLegalTIN':'',
'DirContractorLegalRNNBO':'',
'DirContractorLegalCAT':'',
'DirContractorLegalBIN':'',
'DirContractorLegalOGRNIP':'',
'DirContractorLegalCertificateNumber':'',
'DirContractorLegalCertificateDate':'2016-04-01 00:00:00',
'DirContractorLegalPasSeries':'',
'DirContractorLegalPasNumber':'',
'DirContractorLegalPasCode':'',
'DirContractorLegalPasIssued':'',
'DirContractorLegalPasDate':'1994-01-01 00:00:00',
'DirContractorDesc':'',
'ImageLink':''
}
]";

 
string myParameters = "Key=XXX&pID=ImportDirContractor&

NotStopProcess=false&MatchName=true&MatchTIN_CAT_BIN=true&" + DirContractorCollection;


using (WebClient wc = new WebClient())
{
    wc.Encoding = System.Text.Encoding.UTF8;
    wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
    Label1.Text = wc.UploadString(URI, "POST", myParameters);
}

 
Відповідь сервера, після завершення операції імпорту буде такою:
{'success':true, 'data': {'CountInsert':'0','CountUpdate':'2','CountIgnore':'0'}}
Де параметри:
 - CountInsert – нових записів
 - CountUpdate – оновлено вже існуючих записів
 - CountIgnore – помилок

 

3. Видаткова накладна.

параметри:
DocSalesCollection - JSON-масив має вигляд:
 
[
{
'DirNomenID':'1',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'2',
'PriceVAT':'55'
},
{
'DirNomenID':'2',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'1',
'PriceVAT':'125'
}
]
 
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Контрагент» (ImportDocSales)
NotStopProcess – Продовжити далі, навіть якщо є помилки і приймає значення: false, true
MatchName – Якщо Найменування збігаються, то не створювати нову позицію, а переписати її (UPDATE) і приймає значення: false, true
MatchArticle – Якщо Артикул збігається, то не створювати нову позицію, а переписати її (UPDATE) і приймає значення: false, true

DirWarehouseID -  Склад (його порядковий номер)

DirContractorID -  Контрагент (його порядковий номер)

Org -  Організація (його порядковий номер)

DocDate -  Дата документа


Програмний код на мові програмування .NET C # буде виглядати так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметри
string DocSalesCollection =
"DocSalesCollection=
[
{
'DirNomenID':'1',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'2',
'PriceVAT':'55'
},
{
'DirNomenID':'2',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'1',
'PriceVAT':'125'
}
]";
 
string myParameters =

"Key=XXX&pID=ImportDocSales&" +

"NotStopProcess=false&MatchName=true&MatchArticle=true&" +

"DirWarehouseID=2& DirContractorID=31& DocDate=2016-04-01&" +

DocSalesCollection;
 
using (WebClient wc = new WebClient())
{
    wc.Encoding = System.Text.Encoding.UTF8;
    wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
    Label1.Text = wc.UploadString(URI, "POST", myParameters);
}
 
Відповідь сервера, після завершення операції імпорту буде такою:
{'success':true, 'data': {'CountInsert':'2','CountUpdate':'0','CountIgnore':'0','DocID':'9135'}}
Де параметри:
 - CountInsert – нових записів
 - CountUpdate – оновлено вже існуючих записів
 - CountIgnore – помилок
 - DocID – номер створеного документа

 

4. Прихідна накладна.

параметри:
DocPurchCollection - JSON-масив має вигляд:
 
[
{
'DirNomenID':'1',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'2',
'PriceVAT':'55',
'PriceRetailVAT':'64',
'PriceWholesaleVAT':'62'

},
{
'DirNomenID':'2',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'1',
'PriceVAT':'125',
'PriceRetailVAT':'159',
'PriceWholesaleVAT':'149'
}
]
 
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Контрагент» (ImportDocSales)
NotStopProcess – Продовжити далі, навіть якщо є помилки і приймає значення: false, true
MatchName – Якщо Найменування збігаються, то не створювати нову позицію, а переписати її (UPDATE) і приймає значення: false, true
MatchArticle – Якщо Артикул збігається, то не створювати нову позицію, а переписати її (UPDATE) і приймає значення: false, true

DirWarehouseID -  Склад (його порядковий номер)

DirContractorID -  Контрагент (його порядковий номер)

Org -  Організація (його порядковий номер)

DocDate -  Дата документа

 
Програмний код на мові програмування .NET C # буде виглядати так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметри
string DocPurchCollection =
"DocPurchCollection=

[
{
'DirNomenID':'1',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'2',
'PriceVAT':'55',
'PriceRetailVAT':'64',
'PriceWholesaleVAT':'62'

},
{
'DirNomenID':'2',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'1',
'PriceVAT':'125',
'PriceRetailVAT':'159',
'PriceWholesaleVAT':'149'
}
]

";
 
string myParameters =

"Key=XXX&pID=ImportDocPurch&" +

"NotStopProcess=false&MatchName=true&MatchArticle=true&" +

"DirWarehouseID=2& DirContractorID=31& DocDate=2016-04-01&" +

DocPurchCollection;
 
using (WebClient wc = new WebClient())
{
    wc.Encoding = System.Text.Encoding.UTF8;
    wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
    Label1.Text = wc.UploadString(URI, "POST", myParameters);
}
 
Відповідь сервера, після завершення операції імпорту буде такою:
{'success':true, 'data': {'CountInsert':'2','CountUpdate':'0','CountIgnore':'0','DocID':'9135'}}
Де параметри:
 - CountInsert – нових записів
 - CountUpdate – оновлено вже існуючих записів
 - CountIgnore – помилок
 - DocID – номер створеного документа

 

5. Замовлення покупців.

параметри:
DocOrdersCustomerCollection - JSON-масив має вигляд:
 
[
{
'DirNomenID':'1',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'2',
'PriceVAT':'55',
'DirOrdersStateID':'13'
},
{
'DirNomenID':'2',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'1',
'PriceVAT':'125',
'DirOrdersStateID':'13'
}
]
 
Key – Код ідентифікації
pID – Тип експортованого об'єкта, в даному випадку «Контрагент» (ImportDocSales)
NotStopProcess – Продовжити далі, навіть якщо є помилки і приймає значення: false, true
MatchName – Якщо Найменування збігаються, то не створювати нову позицію, а переписати її (UPDATE) і приймає значення: false, true
MatchArticle – Якщо Артикул збігається, то не створювати нову позицію, а переписати її (UPDATE) і приймає значення: false, true

DirWarehouseID -  Склад (його порядковий номер)

DirContractorID -  Контрагент (його порядковий номер)

Org -  Організація (його порядковий номер)

DocDate -  Дата документу

DirOrdersStateID - Статус замовлення (його порядковий номер)

 
Програмний код на мові програмування .NET C # буде виглядати так:

 
//Рядок з'єднання
string URI = "http://sklad.uchetoblako.ru/API/Api10.ashx";
//Параметри
string DocPurchCollection =
"DocPurchCollection=

[
{
'DirNomenID':'1',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'2',
'PriceVAT':'55',
'DirOrdersStateID':'13'
},
{
'DirNomenID':'2',
'DirNomenArticle':'',
'DirNomenName':'',
'Count':'1',
'PriceVAT':'125',
'DirOrdersStateID':'13'
}
]

";
 
string myParameters =

"Key=XXX&pID=ImportDocOrdersCustomer&" +

"NotStopProcess=false&MatchName=true&MatchArticle=true&" +

"DirWarehouseID=2&DirContractorID=31&DocDate=2016-04-01&DirOrdersStateID=3&" +

DocPurchCollection;
 
using (WebClient wc = new WebClient())
{
    wc.Encoding = System.Text.Encoding.UTF8;
    wc.Headers[HttpRequestHeader.ContentType] = "application/x-www-form-urlencoded";
    Label1.Text = wc.UploadString(URI, "POST", myParameters);
}
 
Відповідь сервера, після завершення операції імпорту буде такою:
{'success':true, 'data': {'CountInsert':'2','CountUpdate':'0','CountIgnore':'0','DocID':'9135'}}
Де параметри:
 - CountInsert – нових записів
 - CountUpdate – оновлено вже існуючих записів
 - CountIgnore – помилок
 - DocID – номер створеного документа

 

 

П.С.

Експорт та імпорт Товару, Контрагентів і Залишків можна здійснювати раз в 10 хвилин
Імпорт Видаткової накладної можна здійснювати без обмежень.
При невдалих 10 спроб з'єднань з сервісом (напр. НЕ правельний параметр Key), буде таймают на 25 хвилин. При тому Ви будете отримувати повідомлення, що ключ не підходить, але перевірка Ключа не відбуватиметься.

 

comments powered by Disqus

+38 050 950-96-49     Карта сайту   

Група УчетОблако в соціальній мережі Google+ УчетОблако в мій бізнес Google+ УчетОблако в соціальній мережі Facebook УчетОблако в соціальній мережі ВКонтакте УчетОблако в соціальній мережі Twitter УчетОблако в YouTube