docs (PUT)

Тип метода

PUT

Назначение

• Выгрузка массива документов из учетной системы на сервер

Где используется

• АРМ.Диспетчера / Документы - Заказы/Возвраты - "Добавить"

Запрос

http://dmd.data-mobile.ru/api/erp/docs  

Content-Type: application/json  
Authorization: Bearer <TOKEN>

Тело

Наименование	Тип	Описание
out_id (обязательно)	string	Идентификатор документа в системе учета
type (обязательно)	int	Тип документа: 0 - Заказ, 1 - Возврат
number (обязательно)	string	Номер документа в системе учета
date (обязательно)	timestamp	Дата создания в формате Unix timestamp
date_from	timestamp	Время начала действия документа
date_to	timestamp	Время окончания действия документа
barcode	string	Штрихкод документа
comment	string	Комментарий документа
priority	int	Приоритет документа
client_name	string	Наименование клиента
recipient	object	Объект информации о получателе
manager	object	Объект информации о менеджере
address (обязательно)	string	Адрес доставки
address_location	string	Координаты доставки в формате "широта,долгота"
user_id	string	Идентификатор пользователя в системе учета
fiscal_tags	string	Фискальные теги в формате json
inn	string	ИНН
payment_preferred_type_id	int	Предпочтительный тип оплаты для Заказов: 0 - наличный, 1 - безналичный, 2 - смешанный
client_notification	object	Объект настроек уведомления для клиента
payments	object array	Массив объектов с данными по оплатам
details	object array	Массив объектов с данными по строкам документа

Пример тела запроса

Выгрузка документа с маркируемыми позициями (по одной из строк выгрузка сразу с КМ)

[  
    {  
        "out_id": "83df1b98-b7a6-11ef-a33f-d04c4ac51d43",  
        "type": 0,  
        "number": "ТД00-000028",  
        "date": 1733778000,  
        "date_from": 1733778000,  
        "date_to": 1733778000,  
        "barcode": "175287309371853769858969354570599570755",  
        "comment": "",  
        "priority": 5,  
        "client_name": "Розничный покупатель",  
        "recipient": {  
            "name": ""  
        },  
        "manager": {  
            "name": "Орлов Александр Владимирович"  
        },  
        "client_notification": {  
            "type": 0,  
            "email": "example@scanport.ru",  
            "phone": "+79001005200"  
        },  
        "address": "Город Москва, Нахимовский проспект, д. 2, стр. а, этаж 8",  
        "address_location": "",  
        "user_id": "6f87e844-722c-11df-b336-0011955cba6b",  
        "fiscal_tags": "{}",  
        "inn": "9999115007",  
        "payment_preferred_type": "2",  
        "payments": [],  
        "details": [  
            {  
                "out_id": "8U-a1680fe8-58a0-11ef-a33d-f365c883963500000000-0000-0000-0000-000000000000",  
                "source_qty": 12,  
                "price": 33,  
                "nds": 6,  
                "fiscal_tags": "{}",  
                "article": {  
                    "out_id": "8U-a1680fe8-58a0-11ef-a33d-f365c883963500000000-0000-0000-0000-000000000000",  
                    "name": "Вода "Липецкий бювет" ",  
                    "short_name": "Вода "Липецкий бювет" ",  
                    "measure_type": 0,  
                    "mark_type": 8,  
                    "subject_type": 0,  
                    "barcodes": [  
                        {  
                            "barcode": "12345",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        },  
                        {  
                            "barcode": "4602124002005",  
                            "unit_coef": 6,  
                            "unit_name": "упак (6 шт)"  
                        },  
                        {  
                            "barcode": "4607050692535",  
                            "unit_coef": 1,  
                            "unit_name": "упак (1 упак)"  
                        },  
                        {  
                            "barcode": "4660114240714",  
                            "unit_coef": 20,  
                            "unit_name": "упак (20 упак)"  
                        },  
                        {  
                            "barcode": "LBX02258517965742508",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        }  
                    ],  
                    "attr_1": "",  
                    "attr_2": "00-00000318",  
                    "attr_3": "",  
                    "attr_4": "",  
                    "attr_5": "",  
                    "attr_6": "",  
                    "attr_7": "",  
                    "attr_8": "",  
                    "attr_9": "",  
                    "attr_10": ""  
                },  
                "marking_codes": [  
                    {  
                        "barcode_raw": "MDEwNDYwMjEyNDAwMjAwNTIxNTBXdHNCOXZjVSYlOB05M0d0VFc=",  
                        "barcode_full": "01046021240020052150WtsB9vcU&%893GtTW"  
                    },  
                    {  
                        "barcode_raw": "MDEwNDYwMjEyNDAwMjAwNTIxNVBTWkhtUnRRJjxOYR05Mzh5bVE=",  
                        "barcode_full": "0104602124002005215PSZHmRtQ&<Na938ymQ"  
                    }  
                ]  
            },  
            {  
                "out_id": "8U-c34ba7ca-71b0-11ef-a33f-d04c4ac51d4300000000-0000-0000-0000-000000000000",  
                "source_qty": 1,  
                "price": 149,  
                "nds": 6,  
                "fiscal_tags": "{}",  
                "article": {  
                    "out_id": "8U-c34ba7ca-71b0-11ef-a33f-d04c4ac51d4300000000-0000-0000-0000-000000000000",  
                    "name": "Молоко сгущенное Рогачевъ ",  
                    "short_name": "Сгущенка Рогачевъ ",  
                    "measure_type": 0,  
                    "mark_type": 5,  
                    "subject_type": 0,  
                    "barcodes": [  
                        {  
                            "barcode": "4600000000005",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        },  
                        {  
                            "barcode": "4602014010929",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        },  
                        {  
                            "barcode": "4602220006549",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        },  
                        {  
                            "barcode": "4629308877044",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        },  
                        {  
                            "barcode": "4670540176099",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        },  
                        {  
                            "barcode": "4810065006079",  
                            "unit_coef": 1,  
                            "unit_name": "шт"  
                        }  
                    ],  
                    "attr_1": "",  
                    "attr_2": "00-00000320",  
                    "attr_3": "",  
                    "attr_4": "",  
                    "attr_5": "",  
                    "attr_6": "",  
                    "attr_7": "",  
                    "attr_8": "",  
                    "attr_9": "",  
                    "attr_10": ""  
                },  
                "marking_codes": []  
            }  
        ]  
    }  
]

Ответ

Возвращается статус код 200

Пример тела ответа

Если документы успешно загружены на сервер, тело ответа будет пустым.

Если некоторые документы не были загружены, возвращается тело ответа с массивом объектов not_saved.

{
    "not_saved": [
        {
            "id": "83df1b98-b7a6-11ef-a33f-d04c4ac51d43",  // id документа, который не удалось записать
            "value": "ТД00-000028",  // номер документа
            "error": "Превышен лимит загрузки документов"  // описание ошибки
        }
    ]
}

См. recipient 

См. manager 

См. client_notification

См. payment 

См. detail