наверх

ќписание форматов дл€ самосто€тельной интеграции 1— с Android и IOS

1. ќбщее

¬ыгружаемые файлы должны иметь формат json.  аждый файл должен быть запакован в zip-архив с паролем, с использованием алгоритма шифровани€ Zip20. јрхив и название файла должны быть одинаковыми и без расширений. ¬се даты должны быть в формате unix time stamp.

2. ќписание структуры файлов

    1. ќбщие данные (кратко обо всем)

Ќазвание файла: main.

—труктура файла:

  1. {

  2. "date" : 1234567890, //“екуща€ дата, на момент формировани€ данных.

  3. УnameФ : УѕрестижФ, //Ќазвание организации.

  4. "cashbox" : [ // ќстатки по всем кассам в сумме, за 30 дней.

  5.    {"date" : 1234567890,

  6.      "sum" : 1234567.89},

  7.    {"date" : 1234567890,

  8.      "sum" : 1234567.89}

  9.    ],   

  10.    "bank" : [ //ќстатки по всем счетам в сумме, за 30 дней.

  11.    {"date" : 1234567890,

  12.      "sum" : 1234567.89},

  13.    {"date" : 1234567890,

  14.      "sum" : 1234567.89}

  15.    ],   

  16.    "incoming" : [ //ѕоступлени€ за 30 дней.

  17.    {"date" : 1234567890,//ƒата, выгружать только даты

  18.                                             // в которых были операции

  19.      "sum" : 1234567.89},//—умма всех операций на дату.

  20.    {"date" : 1234567890,

  21.      "sum" : 1234567.89}

  22.    ],   

  23.    "upcoming" : [ //–асходы за 30 дней. ѕараметры аналогично с incoming.

  24.    {"date" : 1234567890,

  25.      "sum" : 1234567.89},

  26.    {"date" : 1234567890,

  27.      "sum" : 1234567.89}

  28.    ],   

  29.    "debit" : [ // ƒебет, обща€ сумма за каждый день, на 30 дней.

  30.    {"date" : 1234567890,

  31.      "sum" : 1234567.89},

  32.    {"date" : 1234567890,

  33.      "sum" : 1234567.89}

  34.    ],   

  35.    "credit" : [ //  редит, обща€ сумма за каждый день, на 30 дней.

  36.    {"date" : 1234567890,

  37.      "sum" : 1234567.89},

  38.    {"date" : 1234567890,

  39.      "sum" : 1234567.89}

  40.    ]

  41. }


    2. ќстатки по банкам

Ќазвание файла: bank

—труктура файла:

  1. { "days": [

  2.    { "date": 1234567890,

  3.      "sum": 1234567.89},

  4.    { "date": 1234567901,

  5.      "sum": 1234567.89} ],

  6. "accounts": [

  7.    { "name": "Ѕанк ћосквы, расчетный счет",

  8.      "sum": 1234567.89 },

  9.    { "name": "Ѕанк ћосквы, расчетный счет",

  10.      "sum": 1234567.89 } ]}


    3. ќстатки по кассам

Ќазвание файла: cash

—труктура файла:

  1. { "days": [ //ћассив остатков в разрезе дат.

  2.    { "date": 1234567890,//ƒата

  3.      "sum": 1234567.89},//—умма

  4.    { "date": 1234567901,

  5.      "sum": 1234567.89} ],

  6. "cashboxes": [ //ћассив остатков в разрезе касс на текущую дату.

  7.    { "name": " асса организации", // асса

  8.      "sum": 1234567.89 }, //—умма

  9.    { "name": "¬тора€ касса",

  10.      "sum": 1234567.89 } ]}


    4. ѕоступлени€

Ќазвание файла: incoming

—труктура файла:

  1. {

  2. "operations": [ //ћассив операций

  3.    {

  4.      "time": 1234567890, //ƒата поступлени€

  5.      "sum": 1234567.89, //—умма поступлени€

  6.      "partner": "»ѕ »ванов ».».", // онтрагент

  7.      "comment": "ќплата за электричество" //Ќазначение платежа

  8.    },

  9.    {

  10.      "time": 1234567890,

  11.      "sum": 1234567.89,

  12.      "partner": "»ѕ »ванов ».».",

  13.      "comment": "ќплата за электричество"

  14.    }

  15. ]

  16. }



    5. —писани€

Ќазвание файла: upcoming

—труктура файла: тоже что и в поступлени€х


        6. ƒебиторска€ задолженность

Ќазвание файла: debit

—труктура файла:

  1. {

  2. "byDate": [ //ћассив задолженностей в разрезе даты.

  3.    {

  4.      "date": 1234567890, //ƒата

  5.      "sum": 1234567.89 //—умма

  6.    },

  7.    {

  8.      "date": 1234567890,

  9.      "sum": 1234567.89

  10.    }

  11. ],

  12. "byPartner": [ //ћассив задолженностей в разрезе контрагентов

  13.    {

  14.      "partner": "»ѕ »ванов ».».", // онтрагент

  15.      "sum": 1234567.89 //—умма

  16.    },

  17.    {

  18.      "partner": "»ѕ ѕетров ѕ.ѕ.",

  19.      "sum": 1234567.89

  20.    }

  21. ]

  22. }

      

       7.  редиторска€ задолженность

Ќазвание файла: credit

—труктура файла: тоже что и в дебиторской задолженности.


        8. ¬ыручка

Ќазвание файла: sales

—труктура файла:

  1. { "byPartner": [

  2.       { "name": "»ванов ».».",

  3.          "sum": 1234567.89 },

  4.        { "name": "ѕетров ѕ.ѕ",

  5.          "sum": 1234567.89}     

  6. ],

  7.    "year" : [

  8.    { "date" : 1234567890,

  9.      "currentSum" : 1234567.89,

  10.      "pastSum" : 1234567.89 } ,

  11.    { "date" : 1234567890,

  12.      "currentSum" : 1234567.89,

  13.      "pastSum" : 1234567.89 }

  14.    ],

  15.   

  16. "halfYear" : [

  17.    { "date" : 1234567890,

  18.      "currentSum" : 1234567.89,

  19.      "pasteSum" : 1234567.89 } ,

  20.    { "date" : 1234567890,

  21.      "currentSum" : 1234567.89,

  22.      "pastSum" : 1234567.89 }

  23.    ],

  24. "quarter" : [

  25.    { "date" : 1234567890,

  26.      "currentSum" : 1234567.89,

  27.      "pastSum" : 1234567.89 } ,

  28.    { "date" : 1234567890,

  29.      "currentSum" : 1234567.89,

  30.      "pastSum" : 1234567.89 }

  31.    ],

  32.   

  33. "month" : [

  34.    { "date" : 1234567890,

  35.      "currentSum" : 1234567.89,

  36.      "pastSum" : 1234567.89 } ,

  37.    { "date" : 1234567890,

  38.      "currentSum" : 1234567.89,

  39.      "pastSum" : 1234567.89 }

  40.    ]

  41. }

3. QR код

 од будет использоватьс€ дл€ считывани€ реквизитов организации и дл€ входа в приложение.

‘ормат строки, дл€ перевода в QR код:

  1. {

  2.  "id" : "TQmSrz9olz",

  3.  "pin" : "123456",

  4.  "inn" : "1215143804",

  5.  "kpp" : "121501001",

  6.  "rs" : "40702810937000000396 в ќтделение є8614 —бербанка –оссии г. …ошкар-ќла",

  7.  "ks" : "30101810300000000630",

  8.  "bik" : "048860630",

  9.  "location" : "424004, респ.ћарий Ёл, г.…ошкар-ќла, ул.¬олкова, д.68.",

  10.  "phone" : "8 (495) 777-25-43",

  11.  "director" : "ѕ.ћ.јнтонов"

  12. }

пример