Документы
Общие сведения
Шаблоны документов
Шаблон - предзаполненный стандартными полями JSON-объект, который затем можно использовать для успешного создания документа.
Средствами JSON API можно получать предзаполненные шаблоны документов. Они могут быть предзаполнены как на основе других документов, так и стандартными значениями без связей с другими документами.
Для этого, во всех документах, по которым можно получить шаблон, существует специальный ресурс Шаблон документа, адрес которого формируется следующим образом:
https://online.moysklad.ru/api/remap/1.2/entity/<ключевое слово для документа>/new
В тело PUT запроса по данному ресурсу нужно передать метаданные документа, на основе которого будет создан шаблон нового документа, либо просто передать пустое тело запроса.
Метаданные должны быть "обернуты" в объект, имя которого есть ключевое слово для документа-основания в JSON API.
Для каждого из данных ресурсов есть примеры запросов и ответов.
На данный момент можно получить шаблоны следующих документы на основании других:
| Документ |
Основание, на котором он может быть создан |
| Возврат покупателя (salesreturn) |
Отгрузка (demand),
Розничная продажа (retaildemand) |
| Возврат поставщику (purchasereturn) |
Приемка (supply) |
| Отгрузка (demand) |
Заказ покупателя (customerorder) |
| Счет поставщика (invoicein) |
Заказ поставщику (purchaseorder) |
| Cчет покупателю (invoiceout) |
Заказ покупателя (customerorder) |
| Списание (loss) |
Возврат покупателя (salesreturn),
инвентаризация(inventory) |
| Оприходование (enter) |
Инвентаризация(inventory) |
| Заказ поставщику (purchaseorder) |
Внутренний заказ (internalorder) |
| Перемещение (move) |
Внутренний заказ (internalorder) |
| Приходный ордер (cashin) |
Заказ покупателя (salesreturn),
Возврат поставщику (purchasereturn),
Отгрузка (demand),
Счет покупателю (invoiceout),
Полученный отчет комиссионера (commissionreportin) |
| Расходный ордер (cashout) |
Возврат покупателя (salesreturn),
Приемка (supply),
Счет поставщика (invoicein),
Заказ поставщику (purchaseorder),
Выданный отчет комиссионера (commissionreportout) |
| Входящий платеж (paymentin) |
Заказ покупателя (salesreturn),
Возврат поставщику (purchasereturn),
Отгрузка (demand),
Счет покупателю (invoiceout),
Полученный отчет комиссионера (commissionreportin) |
| Исходящий платеж (paymentout) |
Возврат покупателя (salesreturn),
Приемка (supply),
Счет поставщика (invoicein),
Заказ поставщику (purchaseorder),
Выданный отчет комиссионера (commissionreportout) |
| Тех. операция (processing) |
Заказ на производство (processingorder), Тех. карта (processingplan) |
| Заказ на производство (processingorder) |
Тех. карта (processingplan) |
| Розничная продажа (retaildemand) |
Розничная смена, Заказ покупателя |
В результате PUT запроса по /entity/entityName/new НЕ будет создано нового документа.
Возвращаемый предзаполненный объект является лишь "болванкой" с некоторыми заполненными полями (поля заполняются по той же логике,
что и в аналогичной ситуации в основном интерфейсе), облегчающей создание документа. Он не сохраняется в системе. Этот
объект затем можно передать в теле запроса на создание соответствующего документа и тогда уже документ будет создан, и связан с документом-основанием.
Если послать на данный ресурс пустое тело запроса, то в итоговом шаблоне будут предзаполнены лишь стандартные поля в т.ч. указанные в настройках пользователя
в учетной записи сервиса МойСклад.
В случае если инвентаризация содержит более 500 подходящих позиций, то шаблон списания (loss) и оприходования (entry) будет создан по первым 500 позициям.
С подробностями и примерами по каждому из документов можно ознакомиться в соответствующих разделах документации.
Например, для шаблона отгрузки - смотреть в Шаблонах отгрузки
Контекстный поиск для документов
В JSON API можно осуществлять контекстный поиск среди списка сущностей определенного типа по их строковым полям. Для этого
используется URI параметр фильтрации search.
- search
Параметр фильтрации, с помощью которого можно осуществить поиск в списке сущностей. Поиск происходит по основным строковым полям сущностей данного
типа. Результатом поиска будет отсортированный по релевантности список сущностей данного типа, прошедших фильтрацию по переданной поисковой строке. В отличии от фильтрации выборки
с помощью параметра filter, при которой значения проверяются на точное совпадение указанным, при контекстном поиске проверка на совпадение не строгая.
Таким образом, если осуществлять фильтрацию вида
../entity/<entity_type>?filter=name=иван в отфильтрованную выборку попадут только те сущности, поле name
у которых имеет значение иван и никакие другие. При контекстном поиске вида ../entity/<entity_type>?search=иван будут выведены как сущности с name равным
иван, так и сущности, в имени (или в другом строковом поле) которых иван просто содержится, например диван, иванова и т.п.
Поиск среди документов на соответствие поисковой строке будет осуществлен по следующим полям:
+ по наименованию (name)
+ по описанию (description)
+ по входящему номеру (incomingNumber)
- Примеры запросов контекстного поиска (значения должны быть urlencoded):
https://online.moysklad.ru/api/remap/1.2/entity/retaildemand?search=100https://online.moysklad.ru/api/remap/1.2/entity/salesreturn?search=бракhttps://online.moysklad.ru/api/remap/1.2/entity/retailshift?search=ночная
Удаление в корзину
Корзина позволяет избежать риска случайного удаления важных документов. Удаление
в корзину доступно только при наличии у сотрудника соответствующих прав, а также
настроек компании на использовании корзины.
Пример удаления Приемки в корзину
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приемки. |
Запрос на удаление Приемки с указанным id в корзину.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply/be3a3a0e-370c-11e7-1542-821d00000001/trash"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json)
Успешное удаление Приемки.
Связи документов
Привязка документов к документам
Для того чтобы привязать к уже существующему документу другой документ нужно
передать meta привязываемого документа в коллекцию связанных документов этого типа.
Такие коллекции присутствуют среди атрибутов документов. В описании сущностей они описаны в секции Связи с другими документами
и каждое поле называется как ключевое слово для типов привязываемых документов во множественном числе. Например поле invoicesOut у отгрузок
отвечает за связи с счетами покупателю. Если вы хотите привязать к отгрузке счет, в это поле, в составе коллекции, нужно положить meta счета покупателя который вы хотите привязать.
Можно привязывать более 1 документа.
Пример привязки 1
Привязка внутреннего заказа к перемещению.
Параметры
| Параметр |
Описание |
| docname |
string (required) Example: move ключевое слово для документа со связями. |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку внутреннего заказа к перемещению.
СвернутьПоказать
curl -X PUT
"PUT https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Результат - перемещение с заполненным полем internalOrder.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/d9318341-b0da-11e6-8a84-bae5000000c7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "d9318341-b0da-11e6-8a84-bae5000000c7",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-22 20:41:07",
"name": "00001",
"externalCode": "8Fn2HqBbguhZxoYrjWYAf3",
"moment": "2016-11-22 20:40:00",
"applicable": true,
"sum": 0,
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/d9318341-b0da-11e6-8a84-bae5000000c7/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/85a8e439-b0d8-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}
Пример привязки 2
Второй пример запроса на привязку одного документа к другому.
Параметры
| Параметр |
Описание |
| docname |
string (required) Example: move ключевое слово для документа со связями. |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку счета покупателю к отгрузке.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"invoicesOut": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json)
Результат - отгрузка с новым элементом в коллекции invoicesOut.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "06406b97-9138-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-13 14:27:29",
"name": "000201",
"externalCode": "q5Ot--p3gHJrOFylVF2lQ2",
"moment": "2016-10-13 12:38:00",
"applicable": false,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"payedSum": 0,
"invoicesOut": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}
Привязка платежей к документам
К некоторым документам в JSON API могут быть привязаны платежи. Платежи бывают 4-х типов: Входящий платеж, Приходный ордер, Исходящий платеж, Расходный ордер.
Документы, к которым могут быть привязаны платежи содержат вложенную коллекцию payments среди атрибутов документа. Платежи в свою очередь содержат коллекцию operations - операции, к которым привязан данный платеж. Для того, чтобы привязать платеж к документу, нужно в запросах
на создание/обновление платежа в составе коллекции operations указать meta документа. Документы в этой коллекции могут иметь разный тип, однако это не значит, что к любому документу можно привязать все 4 типа платежей. Валидные типы платежей определяются самим документом, к которому происходит привязка. К примеру к полученному отчету комиссионера можно привязать только входящий платеж или приходный ордер.
В результате привзяки платежа, в составе коллекции operations платежа появится новый объект, указывающий на документ, а в составе коллекции payments у документа, к которому
привязывается платеж, появится новый элемент ссылающийся на данный платеж.
Пример привязки платежа 1
Привязка входящего платежа к полученному отчету комиссионера.
Параметры
| Параметр |
Описание |
| docname2 |
string (required) Example: commissionreportin ключевое слово для документа, к которому можно привязать платеж. |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку платежа к полученному отчету комиссионера.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json)
Результат - входящий платеж с новым элементом в коллекции operations.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/94a9f8e9-b30b-11e6-8a84-bae500000017",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "94a9f8e9-b30b-11e6-8a84-bae500000017",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 15:35:00",
"name": "Платеж",
"externalCode": "-S9khhF3gNPa78SPCu81S2",
"moment": "2016-11-25 15:35:00",
"applicable": true,
"sum": 400,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942953e-9128-11e6-8a84-bae500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/a8f3150d-9d39-11e6-8a84-bae500000074",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Пример привязки платежа 2
Привязка приходного ордера к заказу покупателя.
Параметры
| Параметр |
Описание |
| docname2 |
string (required) Example: commissionreportin ключевое слово для документа, к которому можно привязать платеж. |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку приходного ордера к заказу покупателя.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/7944ef04-f831-11e5-7a69-971500188b19
"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json)
Результат - приходный ордер с новым элементом в коллекции operations.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/834d731c-b313-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "834d731c-b313-11e6-8a84-bae50000008e",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 16:31:47",
"name": "1111",
"externalCode": "WpAtzal3hGUnUfQS55x781",
"moment": "2016-11-25 16:31:00",
"applicable": true,
"sum": 32131000,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Валюта в документах
Поле rate содержит объект, представляющий валюту в документах.
Атрибуты объекта валюты
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| currency |
Meta |
Метаданные валюты |
— |
да |
| value |
Float |
Курс валюты в этом документе (содержится в ответе, если значение курса отлично от 1) |
— |
нет |
Вместо ссылки на валюту можно получить объект валюты целиком с помощью параметра запроса ?expand=rate.currency.
Розничная смена
Розничные смены
Средствами JSON API можно запрашивать списки Розничных смен и сведения по отдельным Розничным сменам. Кодом сущности для Розничной смены в составе JSON API является ключевое слово retailshift.
Операции
С помощью данного ресурса вы не можете создавать или обновлять Розничные смены. Создание новой розничной смены происходит
при выполнении запроса на Открытие смены через отдельный API подключения торговой точки к онлайн-сервису МойСклад POS API 1.0. Для совершения операции Открытие розничной смены необходимо
аутентифицироваться с правами Кассира.
Атрибуты смены
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| meta |
Meta |
Метаданные Розничной смены |
Только для чтения |
да |
| id |
UUID |
ID Розничной смены |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| syncId |
UUID |
ID синхронизации. После заполнения недоступен для изменения |
Только для чтения |
нет |
| updated |
DateTime |
Момент последнего обновления Розничной смены |
Только для чтения |
да |
| deleted |
DateTime |
Момент последнего удаления Розничной смены |
Только для чтения |
нет |
| name |
String(255) |
Наименование Розничной смены |
Только для чтения |
да |
| description |
String(4096) |
Комментарий Розничной смены |
Только для чтения |
нет |
| externalCode |
String(255) |
Внешний код Розничной смены |
Только для чтения |
да |
| moment |
DateTime |
Дата смены |
Только для чтения |
да |
| vatEnabled |
Boolean |
Учитывается ли НДС |
Только для чтения |
да |
| vatIncluded |
Boolean |
Включен ли НДС в цену |
Только для чтения |
нет |
| owner |
Meta |
Владелец (Сотрудник) |
Только для чтения |
да |
| shared |
Boolean |
Общий доступ |
Только для чтения |
да |
| group |
Meta |
Отдел сотрудника |
Только для чтения |
да |
| organization |
Meta |
Метаданные юрлица |
Только для чтения |
да |
| agent |
Meta |
Метаданные контрагента |
Только для чтения |
нет |
| store |
Meta |
Метаданные склада |
Только для чтения |
да |
| contract |
Meta |
Метаданные договора |
Только для чтения |
нет |
| organizationAccount |
Meta |
Метаданные счета юрлица |
Только для чтения |
нет |
| agentAccount |
Meta |
Метаданные счета контрагента |
Только для чтения |
нет |
| attributes |
Array(Object) |
Коллекция метаданных доп. полей. Поля объекта |
Только для чтения |
нет |
| files |
MetaArray |
Массив метаданных Файлов (Максимальное количество файлов - 100) |
— |
да |
| created |
DateTime |
Дата создания |
Только для чтения |
да |
| printed |
Boolean |
Напечатан ли документ |
Только для чтения |
да |
| published |
Boolean |
Опубликован ли документ |
Только для чтения |
да |
| closeDate |
DateTime |
Дата закрытия смены |
Только для чтения |
нет |
| proceedsNoCash |
Float |
Выручка безнал |
Только для чтения |
да |
| proceedsCash |
Float |
Выручка наличными |
Только для чтения |
да |
| receivedNoCash |
Float |
Получено безнал |
Только для чтения |
да |
| receivedCash |
Float |
Получено наличными |
Только для чтения |
да |
| retailStore |
Meta |
Метаданные точки продаж |
Только для чтения |
да |
| operations |
Array(Object) |
Коллекция метаданных связанных операций |
Только для чтения |
да |
| paymentOperations |
Array(Object) |
Коллекция метаданных платежных операций |
Только для чтения |
нет |
О работе с доп. полями Розничных смен можно прочитать здесь
Получить Розничные смены
Запрос на получение списка всех Розничных смен на данной учетной записи.
Результат успешного запроса - JSON представление списка Розничных смен с перечисленными полями:
| Название |
Тип |
Описание |
| meta |
Meta |
Метаданные о выдаче, |
| context |
Meta |
Метаданные о сотруднике, выполнившем запрос. |
| rows |
Array(Object) |
Массив JSON объектов, представляющих собой Розничные смены. |
Параметры
| Параметр |
Описание |
| limit |
number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset |
number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Розничные смены
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Розничных смен.
СвернутьПоказать
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift",
"type": "retailshift",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
},
"id": "0b2b2caf-055e-11e6-9464-e4de0000007c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-18 15:07:12",
"name": "00001",
"externalCode": "iR5ZTLzfhK98uzqIFbC871",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-18 15:06:51",
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"vatEnabled": true,
"vatIncluded": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "AttributeName1",
"type": "string",
"value": "Да"
}
],
"closeDate": "2016-04-18 15:07:12",
"proceedsNoCash": 0,
"proceedsCash": 5100,
"receivedNoCash": 0,
"receivedCash": 5136,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/29547f06-ec69-11e7-0532-9eed0000001b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildemand/edit?id=29547f06-ec69-11e7-0532-9eed0000001b"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/3395a278-ec69-11e7-0532-9eed00000022",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retailsalesreturn/edit?id=3395a278-ec69-11e7-0532-9eed00000022"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2eb3c0ad-f9d9-11e7-0532-9eed0000005a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashin/edit?id=2eb3c0ad-f9d9-11e7-0532-9eed0000005a"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/3d8258c5-f9d9-11e7-0532-9eed0000005e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashout/edit?id=3d8258c5-f9d9-11e7-0532-9eed0000005e"
}
}
],
"paymentOperations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/6c3237ff-f9d9-11e7-0532-9eed00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#cashin/edit?id=6c3237ff-f9d9-11e7-0532-9eed00000086"
},
"linkedSum": 0
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/5952a2fb-f9d8-11e7-0532-9eed00000036",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#paymentin/edit?id=5952a2fb-f9d8-11e7-0532-9eed00000036"
},
"linkedSum": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/cd86df19-0563-11e6-9464-e4de0000008e",
"type": "retailshift",
"mediaType": "application/json"
},
"id": "cd86df19-0563-11e6-9464-e4de0000008e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-18 15:48:19",
"name": "00002",
"externalCode": "uhM2bdwAg7661Qhx3f7102",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-18 15:48:04",
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"vatEnabled": true,
"vatIncluded": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "AttributeName1",
"type": "string",
"value": "Да"
}
],
"closeDate": "2016-04-18 15:48:19",
"proceedsNoCash": 1800,
"proceedsCash": 0,
"receivedNoCash": 0,
"receivedCash": 0,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/29547f06-ec69-11e7-0532-9eed0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildemand/edit?id=29547f06-ec69-11e7-0532-9eed0000002c"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/3395a278-ec69-11e7-0532-9eed00000033",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retailsalesreturn/edit?id=3395a278-ec69-11e7-0532-9eed00000033"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2eb3c0ad-f9d9-11e7-0532-9eed0000006b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashin/edit?id=2eb3c0ad-f9d9-11e7-0532-9eed0000006b"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/3d8258c5-f9d9-11e7-0532-9eed0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashout/edit?id=3d8258c5-f9d9-11e7-0532-9eed0000006a"
}
}
],
"paymentOperations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/6c3237ff-f9d9-11e7-0532-9eed00000099",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#cashin/edit?id=6c3237ff-f9d9-11e7-0532-9eed00000099"
},
"linkedSum": 0
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/5952a2fb-f9d8-11e7-0532-9eed00000048",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#paymentin/edit?id=5952a2fb-f9d8-11e7-0532-9eed00000048"
},
"linkedSum": 0
}
]
}
]
}
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной смены. |
Запрос на удаление Розничной смены с указанным id.
СвернутьПоказать
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешное удаление Розничной смены.
Запрос на получение метаданных Розничных смен. Результат - объект JSON, включающий в себя:
| Параметр |
Описание |
| meta |
Ссылка на метаданные Розничных смен |
| attributes |
Массив объектов доп. полей Розничных смен в формате Метаданных |
| createShared |
создавать новые Розничные смены с меткой "Общий" |
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Розничных смен
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление доп. полей Розничных продаж.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "AttributeName1",
"type": "string",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/d335f74e-558c-11e6-8a84-bae50000009a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d335f74e-558c-11e6-8a84-bae50000009a",
"name": "AttributeName1",
"type": "file",
"required": false
}
Розничная смена
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной смены. |
Запрос на получение отдельной Розничной смены с указанным id.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Розничной смены.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/91a42d66-0ad2-11e6-9464-e4de00000017",
"type": "retailshift",
"mediaType": "application/json"
},
"id": "91a42d66-0ad2-11e6-9464-e4de00000017",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-25 13:50:05",
"name": "00004",
"externalCode": "33Ox0o1GjpDZC9x41fUA11",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-25 13:10:19",
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"vatEnabled": true,
"vatIncluded": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "AttributeName1",
"type": "string",
"value": "Да"
}
],
"closeDate": "2016-04-25 13:10:19",
"proceedsNoCash": 0,
"proceedsCash": 0,
"receivedNoCash": 0,
"receivedCash": 0,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/29547f06-ec69-11e7-0532-9eed0000001b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildemand/edit?id=29547f06-ec69-11e7-0532-9eed0000001b"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/3395a278-ec69-11e7-0532-9eed00000022",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retailsalesreturn/edit?id=3395a278-ec69-11e7-0532-9eed00000022"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2eb3c0ad-f9d9-11e7-0532-9eed0000005a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashin/edit?id=2eb3c0ad-f9d9-11e7-0532-9eed0000005a"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/3d8258c5-f9d9-11e7-0532-9eed0000005e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashout/edit?id=3d8258c5-f9d9-11e7-0532-9eed0000005e"
}
}
],
"paymentOperations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/6c3237ff-f9d9-11e7-0532-9eed00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#cashin/edit?id=6c3237ff-f9d9-11e7-0532-9eed00000086"
},
"linkedSum": 0
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/5952a2fb-f9d8-11e7-0532-9eed00000036",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#paymentin/edit?id=5952a2fb-f9d8-11e7-0532-9eed00000036"
},
"linkedSum": 0
}
]
}
Оприходование
Средствами JSON API можно создавать и обновлять сведения об Оприходованиях, запрашивать списки Оприходований и сведения по отдельным Оприходованиям. Позициями Оприходований можно управлять как в составе отдельного Оприходования, так и отдельно - с помощью специальных ресурсов для управления позициями Оприходования. Кодом сущности для Оприходования в составе JSON API является ключевое слово enter. Больше об Оприходованиях можно прочитать этой ссылке.
Оприходования
Атрибуты сущности
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| meta |
Meta |
Метаданные Оприходования |
— |
да |
| id |
UUID |
ID Оприходования |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| syncId |
UUID |
ID синхронизации. После заполнения недоступен для изменения |
— |
нет |
| updated |
DateTime |
Момент последнего обновления Оприходования |
Только для чтения |
да |
| deleted |
DateTime |
Момент последнего удаления Оприходования |
Только для чтения |
нет |
| name |
String(255) |
Номер Оприходования |
— |
да |
| description |
String(4096) |
Комментарий Оприходования |
— |
нет |
| externalCode |
String(255) |
Внешний код Оприходования |
— |
да |
| moment |
DateTime |
Дата Оприходования |
— |
да |
| applicable |
Boolean |
Отметка о проведении |
— |
да |
| sum |
Int |
Сумма Оприходования в копейках |
Только для чтения |
да |
| rate |
Object |
Валюта. Подробнее тут |
— |
да |
| owner |
Meta |
Владелец (Сотрудник) |
— |
да |
| shared |
Boolean |
Общий доступ |
— |
да |
| group |
Meta |
Отдел сотрудника |
— |
да |
| organization |
Meta |
Метаданные юрлица |
Необходимое при создании |
да |
| store |
Meta |
Метаданные склада |
Необходимое при создании |
да |
| contract |
Meta |
Метаданные договора |
— |
нет |
| project |
Meta |
Метаданные проекта |
— |
нет |
| state |
Meta |
Метаданные статуса оприходования |
— |
нет |
| attributes |
Array(Object) |
Коллекция метаданных доп. полей. Поля объекта |
— |
нет |
| files |
MetaArray |
Массив метаданных Файлов (Максимальное количество файлов - 100) |
— |
да |
| created |
DateTime |
Дата создания |
Только для чтения |
да |
| printed |
Boolean |
Напечатан ли документ |
Только для чтения |
да |
| published |
Boolean |
Опубликован ли документ |
Только для чтения |
да |
| positions |
MetaArray |
Метаданные позиций Оприходования |
— |
да |
| overhead |
Object |
Накладные расходы. Подробнее тут. Если Позиции Оприходования не заданы, то накладные расходы нельзя задать |
— |
нет |
Накладные расходы
Описание полей overhead
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| sum |
Int |
Сумма Оприходования в копейках |
— |
да |
| distribution |
Enum |
Распределение накладных расходов [weight, volume, price] -> [по весу, по объему, по цене] |
— |
да |
Позиции Оприходования
Позиции Оприходования - это список товаров/услуг/модификаций/серий.
Объект позиции Оприходования содержит следующие поля:
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| id |
UUID |
ID позиции |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| quantity |
Int |
Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе. |
— |
да |
| price |
Float |
Цена товара/услуги в копейках |
— |
да |
| gtd |
String(255) |
ГТД |
— |
нет |
| country |
Meta |
Метаданные страны |
— |
нет |
| assortment |
Meta |
Метаданные товара/услуги/серии/модификации, которую представляет собой позиция |
— |
да |
| pack |
String(255) |
Упаковка товара |
— |
нет |
| things |
Object(String) |
Серийные номера. Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете. В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута. |
— |
нет |
| reason |
String(255) |
Причина оприходования данной позиции |
— |
нет |
| overhead |
Object |
Накладные расходы. Подробнее тут. Если Позиции Оприходования не заданы, то накладные расходы нельзя задать |
— |
да |
С позициями можно работать с помощью специальных ресурсов для управления позициями Оприходования,
а также в составе отдельного Оприходования. При работе в составе отдельного Оприходования,
вы можете отправлять запросы на создание отдельного Оприходования с включенным в тело запроса
массивом позиций Оприходования. Если количество позиций превышает максимально допустимое, то для
дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Оприходования".
Также, при работе в составе отдельного Оприходования, можно отправлять запросы на обновление списка позиций
с включенным в тело запроса массивом позиций Оприходования. При этом важно помнить, что коллекция позиций будет
восприниматься как "все позиции Оприходования" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние
позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Оприходований можно прочитать здесь
Получать Оприходования
Запрос всех Оприходований на данной учетной записи.
Результат: Объект JSON, включающий в себя поля:
| Название |
Тип |
Описание |
| meta |
Meta |
Метаданные о выдаче, |
| context |
Meta |
Метаданные о сотруднике, выполнившем запрос. |
| rows |
Array(Object) |
Массив JSON объектов, представляющих собой Оприходования. |
Параметры
| Параметр |
Описание |
| limit |
number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset |
number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search |
string (optional) Example: 0001 Фильтр документов по указанной поисковой строке. |
Получать Оприходования
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Оприходований.
СвернутьПоказать
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "2e12d827-5338-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 16:52:23",
"name": "00002",
"externalCode": "xmlPt1lUie1p18VedA1M-3",
"moment": "2016-07-26 16:51:00",
"applicable": true,
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 26400,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/bf19f3fe-4f28-11e6-8a84-bae50000006d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "bf19f3fe-4f28-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 12:51:50",
"name": "00001",
"externalCode": "9CC4OgVhhJwPTl3289w0q1",
"moment": "2016-07-21 12:51:00",
"applicable": true,
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"sum": 13200,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/bf19f3fe-4f28-11e6-8a84-bae50000006d/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Оприходования
Запрос на создание нового Оприходования.
Обязательные для создания поля:
| Название |
Тип |
Описание |
| organization |
Meta |
Метаданные юрлица |
| store |
Meta |
Метаданные склада |
Пример создания нового Оприходования с телом запроса, содержащим только необходимые поля.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"sum": 51241240,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "АБЫР",
"overhead": 0
},
{
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновленная причина",
"overhead": 0
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 404
}
],
"overhead": {
"sum": 40400,
"distribution": "weight"
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Оприходования.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:16:04",
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1026732,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "AttributeName1",
"type": "string",
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "AttributeName2",
"type": "long",
"value": 404
}
],
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"overhead": {
"sum": 40400,
"distribution": "weight"
}
}
Массовое создание и обновление Оприходований
Массовое создание и обновление Оприходований.
В теле запроса нужно передать массив, содержащий JSON представления Оприходований, которые вы хотите создать или обновить.
Обновляемые Оприходования должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Оприходований
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"sum": 51241240,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "АБЫР",
"overhead": 0
},
{
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновленная причина",
"overhead": 0
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 404
}
],
"overhead": {
"sum": 40400,
"distribution": "weight"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 13:46:22",
"applicable": false,
"sum": 333,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "AttributeValue2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 501
}
],
"positions": [],
"overhead": {
"sum": 40400,
"distribution": "price"
}
}
]'
Response 200 (application/json)
Успешный запрос. Результат - массив JSON представлений созданных и обновленных Оприходований.
СвернутьПоказать
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:16:04",
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1026732,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "AttributeName1",
"type": "string",
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "AttributeName2",
"type": "long",
"value": 404
}
],
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"overhead": {
"sum": 40400,
"distribution": "weight"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:21:18",
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 12:46:22",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "AttributeName1",
"type": "string",
"value": "AttributeValue2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "AttributeName2",
"type": "long",
"value": 501
}
],
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
]
Удалить Оприходование
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Запрос на удаление Оприходования с указанным id.
СвернутьПоказать
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешное удаление Оприходования.
Массовое удаление Оприходований
В теле запроса нужно передать массив, содержащий JSON метаданных Оприходований, которые вы хотите удалить.
Запрос на массовое удаление Оприходований.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter/delete"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
}
]'
Успешный запрос. Результат - JSON информация об удалении Оприходований.
СвернутьПоказать
[
{
"info":"Сущность 'enter' с UUID: 7944ef04-f831-11e5-7a69-971500188b1 успешно удалена"
},
{
"info":"Сущность 'enter' с UUID: 7944ef04-f831-11e5-7a69-971500188b2 успешно удалена"
}
]
Запрос на получение метаданных Оприходований. Результат - объект JSON, включающий в себя:
| Параметр |
Описание |
| meta |
Ссылка на метаданные Оприходований |
| attributes |
Массив объектов доп. полей Оприходований в формате Метаданных |
| states |
Массив статусов Оприходований |
| createShared |
создавать новых Оприходованияс меткой "Общий" |
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Оприходований
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление метаданных Оприходований.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "AttributeName1",
"type": "boolean",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "AttributeName2",
"type": "long",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "AttributeName1",
"type": "string",
"required": false
}
Оприходование
Получить Оприходование
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Запрос на получение отдельного оприходования с указанным id.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Оприходования.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "2e12d827-5338-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 16:52:23",
"name": "00002",
"externalCode": "xmlPt1lUie1p18VedA1M-3",
"moment": "2016-07-26 16:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 26400,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
}
}
Изменить Оприходование
Запрос на обновление оприходования с указанным id.
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Пример запроса на обновление отдельного Оприходования.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 13:46:22",
"applicable": false,
"sum": 333,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 501
}
],
"positions": [],
"overhead": {
"sum": 40400,
"distribution": "price"
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленного Оприходования.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:21:18",
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 12:46:22",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "AttributeName1",
"type": "string",
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "AttributeName2",
"type": "long",
"value": 501
}
],
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Позиции Оприходований
Отдельный ресурс для управления позициями Оприходования. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 1000. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Оприходования
Запрос на получение списка всех позиций данного Оприходования.
| Название |
Тип |
Описание |
| meta |
Meta |
Метаданные о выдаче, |
| context |
Meta |
Метаданные о сотруднике, выполнившем запрос. |
| rows |
Array(Object) |
Массив JSON объектов, представляющих собой позиции Оприходования. |
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| limit |
number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset |
number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Оприходования
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка позиций отдельного Оприходования.
СвернутьПоказать
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/2e12e9aa-5338-11e6-8a84-bae50000008f",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12e9aa-5338-11e6-8a84-bae50000008f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=e64d0a86-2a99-11e9-ac12-000c00000041"
}
},
"gtd": {
"name": "12345678/121217/1212321"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"reason": "ЧТо то не так",
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/2e12f062-5338-11e6-8a84-bae500000090",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12f062-5338-11e6-8a84-bae500000090",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00de5b31-3303-11e6-8a84-bae500000344",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3b1e1f15-2842-11e9-ac12-000c0000002f"
}
},
"reason": "НЕОБХОДИМО",
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/2e12f5d2-5338-11e6-8a84-bae500000091",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12f5d2-5338-11e6-8a84-bae500000091",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0572d2fc-3303-11e6-8a84-bae500000842",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=392c045c-2842-11e9-ac12-000a00000002"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/2e12fb31-5338-11e6-8a84-bae500000092",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12fb31-5338-11e6-8a84-bae500000092",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3bb1af6c-2842-11e9-ac12-000c00000061"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/2e1300c8-5338-11e6-8a84-bae500000093",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e1300c8-5338-11e6-8a84-bae500000093",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3bad99f1-2842-11e9-ac12-000c0000005c"
}
},
"gtd": {
"name": "12345678/121217/1235362"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"reason": "АБЫР",
"overhead": 0
}
]
}
Создать позицию Оприходования
Запрос на создание новой позиции в Оприходовании.
Для успешного создания необходимо в теле запроса указать следующие поля:
- assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция.
Также можно указать поле с именем service, consignment, variant в соответствии с тем,
чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Оприходования
- quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Одновременно можно создать как одну так и несколько позиций Оприходования. Все созданные данным запросом позиции
будут добавлены к уже существующим.
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Пример создания позиций в Оприходовании.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 103,
"price": 566230,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Срочная нужда",
"overhead": 305
},
{
"quantity": 13,
"price": 12560,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Необходимый товар",
"overhead": 50607080
}
]'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданной позиции отдельного Оприходования.
СвернутьПоказать
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7ffb0be4-5339-11e6-8a84-bae500000016",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7ffb0be4-5339-11e6-8a84-bae500000016",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 103,
"price": 566230,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=3bad99f1-2842-11e9-ac12-000c0000005c"
}
},
"reason": "Срочная нужда",
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7ffb1271-5339-11e6-8a84-bae500000017",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7ffb1271-5339-11e6-8a84-bae500000017",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 13,
"price": 12560,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=3bb1af6c-2842-11e9-ac12-000c00000061"
}
},
"reason": "Необходимый товар",
"overhead": 0
}
]
Позиция Оприходования
Получить позицию
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| positionID |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b20 id позиции. |
Запрос на получение отдельной позиции Оприходования с указанным id.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельной позиции Оприходования.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7944ef04-f831-11e5-7a69-971500188b20",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00de5b31-3303-11e6-8a84-bae500000344",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3bb1af6c-2842-11e9-ac12-000c00000061"
}
},
"reason": "НЕОБХОДИМО",
"overhead": 0
}
Изменить позицию
Запрос на обновление отдельной позиции Оприходования. Для обновления позиции нет каких-либо
обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| positionID |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b20 id позиции. |
Пример запроса на обновление отдельной позиции в Оприходовании.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновленная причина"
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленной позиции Оприходования.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7944ef04-f831-11e5-7a69-971500188b20",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=3bb1af6c-2842-11e9-ac12-000c00000061"
}
},
"reason": "Обновленная причина",
"overhead": 0
}
Удалить позицию
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| positionID |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b20 id позиции. |
Запрос на удаление отдельной позиции Оприходования с указанным id.
СвернутьПоказать
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешное удаление позиции Оприходования.
Заказ покупателя
Заказы покупателей
Средствами JSON API можно создавать и обновлять сведения о Заказах покупателя, запрашивать списки Заказов и сведения по отдельным Заказам покупателей. Позициями Заказов можно управлять как в составе отдельного Заказа покупателя, так и отдельно - с помощью специальных ресурсов для управления позициями Заказа. Кодом сущности для Заказа покупателя в составе JSON API является ключевое слово customerorder. Больше о Заказах покупателей и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| meta |
Meta |
Метаданные Заказа покупателя |
— |
да |
| id |
UUID |
ID Заказа покупателя |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| syncId |
UUID |
ID синхронизации. После заполнения недоступен для изменения |
— |
нет |
| updated |
DateTime |
Момент последнего обновления Заказа покупателя |
Только для чтения |
да |
| deleted |
DateTime |
Момент последнего удаления Заказа покупателя |
Только для чтения |
нет |
| name |
String(255) |
Наименование Заказа покупателя |
— |
да |
| description |
String(4096) |
Комментарий Заказа покупателя |
— |
нет |
| externalCode |
String(255) |
Внешний код Заказа покупателя |
— |
да |
| moment |
DateTime |
Дата Заказа |
— |
да |
| applicable |
Boolean |
Отметка о проведении |
— |
да |
| vatEnabled |
Boolean |
Учитывается ли НДС |
— |
да |
| vatIncluded |
Boolean |
Включен ли НДС в цену |
— |
нет |
| sum |
Int |
Сумма Заказа в установленной валюте |
Только для чтения |
да |
| rate |
Object |
Валюта. Подробнее тут |
— |
да |
| owner |
Meta |
Владелец (Сотрудник) |
— |
да |
| shared |
Boolean |
Общий доступ |
— |
да |
| group |
Meta |
Отдел сотрудника |
— |
да |
| organization |
Meta |
Метаданные юрлица |
Необходимое при создании |
да |
| agent |
Meta |
Метаданные контрагента |
Необходимое при создании |
да |
| store |
Meta |
Метаданные склада |
— |
да |
| contract |
Meta |
Метаданные договора |
— |
нет |
| state |
Meta |
Метаданные статуса заказа |
— |
нет |
| organizationAccount |
Meta |
Метаданные счета юрлица |
— |
нет |
| agentAccount |
Meta |
Метаданные счета контрагента |
— |
нет |
| attributes |
Array(Object) |
Коллекция метаданных доп. полей. Поля объекта |
— |
нет |
| files |
MetaArray |
Массив метаданных Файлов (Максимальное количество файлов - 100) |
— |
да |
| created |
DateTime |
Дата создания |
Только для чтения |
да |
| printed |
Boolean |
Напечатан ли документ |
Только для чтения |
да |
| published |
Boolean |
Опубликован ли документ |
Только для чтения |
да |
| vatSum |
Float |
Сумма НДС |
Только для чтения |
да |
| positions |
MetaArray |
Метаданные позиций Заказа покупателя |
— |
да |
| deliveryPlannedMoment |
DateTime |
Планируемая дата отгрузки |
— |
нет |
| payedSum |
Float |
Сумма входящих платежей по Заказу |
Только для чтения |
да |
| shippedSum |
Float |
Сумма отгруженного |
Только для чтения |
да |
| invoicedSum |
Float |
Сумма счетов покупателю |
Только для чтения |
да |
| reservedSum |
Float |
Сумма товаров в резерве |
Только для чтения |
да |
| project |
Meta |
Метаданные проекта |
— |
нет |
| taxSystem |
Enum |
Код системы налогообложения. Подробнее тут |
— |
нет |
Код системы налогообложения
Значения поля taxSystem.
| Значение |
Описание |
| GENERAL_TAX_SYSTEM |
ОСН |
| SIMPLIFIED_TAX_SYSTEM_INCOME |
УСН. Доход |
| SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME |
УСН. Доход-Расход |
| UNIFIED_AGRICULTURAL_TAX |
ЕСХН |
| PRESUMPTIVE_TAX_SYSTEM |
ЕНВД |
| PATENT_BASED |
Патент |
Связи с другими документами
| Название |
Описание |
| purchaseOrders |
Массив ссылок на связанные заказы поставщикам в формате Метаданных |
| demands |
Массив ссылок на связанные отгрузки в формате Метаданных |
| payments |
Массив ссылок на связанные платежи в формате Метаданных |
| invoicesOut |
Массив ссылок на связанные счета покупателям в формате Метаданных |
Позиции Заказа покупателя
Позиции Заказа - это список товаров/услуг/модификаций/серий.
Объект позиции Заказа содержит следующие поля:
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| id |
UUID |
ID позиции |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| quantity |
Int |
Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе. |
— |
да |
| price |
Float |
Цена товара/услуги в копейках |
— |
да |
| discount |
Int |
Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10% |
— |
да |
| vat |
Int |
НДС, которым облагается текущая позиция |
— |
да |
| assortment |
Meta |
Метаданные товара/услуги/серии/модификации, которую представляет собой позиция |
— |
да |
| pack |
String(255) |
Упаковка товара |
— |
нет |
| shipped |
Int |
Доставлено |
— |
да |
| reserve |
Int |
Резерв данной позиции |
— |
нет |
| taxSystem |
Enum |
Код системы налогообложения. Подробнее тут |
— |
нет |
С позициями можно работать с помощью специальных ресурсов для управления позициями Заказа,
а также в составе отдельного Заказа покупателя. При работе в составе отдельного Заказа покупателя,
вы можете отправлять запросы на создание отдельного Заказа покупателя с включенным в тело запроса
массивом позиций Заказа. Если количество позиций превышает максимально допустимое, то для
дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Заказа покупателя".
Также, при работе в составе отдельного Заказа покупателя, можно отправлять запросы на обновление списка позиций
с включенным в тело запроса массивом позиций Заказа. При этом важно помнить, что коллекция позиций будет
восприниматься как "все позиции Заказа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние
позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Заказов покупателей можно прочитать здесь
Получить список Заказов покупателей
Запрос всех Заказов покупателей на данной учетной записи.
Результат: Объект JSON, включающий в себя поля:
| Название |
Тип |
Описание |
| meta |
Meta |
Метаданные о выдаче, |
| context |
Meta |
Метаданные о сотруднике, выполнившем запрос. |
| rows |
Array(Object) |
Массив JSON объектов, представляющих собой Заказы покупателей. |
Параметры
| Параметр |
Описание |
| limit |
number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset |
number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search |
string (optional) Example: 0001 Фильтр документов по указанной поисковой строке. |
Получить список Заказов покупателей
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Заказов покупателей.
СвернутьПоказать
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder",
"type": "customerorder",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "34efe2ee-015e-11e6-9464-e4de0000006b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 12:03:05",
"name": "00001",
"description": "Это комментарий к заказу покупателя!",
"externalCode": "CntjFix4hoyZOIhZiULjv2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-13 12:57:00",
"applicable": true,
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346453701206,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/bc1b4fde-019a-11e6-9464-e4de00000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 214
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "AttributeName1",
"type": "string",
"value": "1251252"
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 346389501206,
"deliveryPlannedMoment": "2016-04-15 12:58:00",
"payedSum": 365939611804,
"shippedSum": 408739611676,
"invoicedSum": 408739611676,
"taxSystem": "GENERAL_TAX_SYSTEM"
}
]
}
Создать Заказ покупателя
Запрос на создание нового Заказа покупателя.
Обязательные для создания поля:
| Параметр |
Описание |
| name |
номер Заказа покупателя |
| organization |
Ссылка на ваше юрлицо в формате Метаданных |
| agent |
Ссылка на контрагента (покупателя) в формате Метаданных |
Пример создания нового Заказа с телом запроса, содержащим только необходимые поля.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "00003",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "d9ceb08f-01ae-11e6-9464-e4de00000020",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:02:24",
"name": "00003",
"externalCode": "08ehdxhRgVIB5-Sa-QNI42",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-14 13:02:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример создания нового Заказа с более насыщенным телом запроса.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"code": "1243521",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterperty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на создание Заказа покупателя с доп. полями.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name" : "000034",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"code" : "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "Атрибут заказа",
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"code": "1243521",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "AttributeName1",
"type": "string",
"value": "Атрибут заказа",
}
],
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на создание Заказа покупателя с позициями в теле запроса.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20
},
{
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
},
"pack": {
"id": "1bf22e62-8b47-11e8-56c0-000800000006"
},
"reserve": 30
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"version": 0,
"updated": "2016-04-14 13:08:58",
"name": "000034",
"code": "1243521",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterperty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"documents": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/06406b97-9138-11e6-8a84-bae500000000/documents",
"mediaType": "application/json",
"size": 0,
"limit": 100,
"offset": 0
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 100,
"offset": 0
}
},
"reservedSum": 10000,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Массовое создание и обновление Заказов покупателей
Массовое создание и обновление Заказов покупателей.
В теле запроса нужно передать массив, содержащий JSON представления Заказов покупателей, которые вы хотите создать или обновить.
Обновляемые Заказы покупателей должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Заказов покупателей
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"name": "00003",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"name": "000039",
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json)
Успешный запрос. Результат - массив JSON представлений созданных и обновленных Заказов покупателей.
СвернутьПоказать
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "d9ceb08f-01ae-11e6-9464-e4de00000020",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:02:24",
"name": "00003",
"externalCode": "08ehdxhRgVIB5-Sa-QNI42",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-14 13:02:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true, "positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
]
Удалить Заказ покупателя
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Запрос на удаление Заказа покупателя с указанным id.
СвернутьПоказать
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешное удаление Заказа покупателя.
Запрос на получение метаданных Заказов покупателей. Результат - объект JSON, включающий в себя:
| Параметр |
Описание |
| meta |
Ссылка на метаданные Заказов покупателей |
| attributes |
Массив объектов доп. полей Заказов покупателей в формате Метаданных |
| states |
Массив статусов Заказов покупателей |
| createShared |
создавать новые Заказы покупателей с меткой "Общий" |
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Массовое удаление Заказов покупателей
В теле запроса нужно передать массив, содержащий JSON метаданных Заказов покупателей, которые вы хотите удалить.
Запрос на массовое удаление Заказов покупателей.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/delete"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
]'
Успешный запрос. Результат - JSON информация об удалении Заказов покупателей.
СвернутьПоказать
[
{
"info":"Сущность 'customerorder' с UUID: 7944ef04-f831-11e5-7a69-971500188b1 успешно удалена"
},
{
"info":"Сущность 'customerorder' с UUID: 7944ef04-f831-11e5-7a69-971500188b2 успешно удалена"
}
]
Метаданные Заказов покупателей
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление доп. полей Заказов покупателей.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/c2ecd338-015e-11e6-9464-e4de0000008f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"name": "AttributeName1",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "customerorder"
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/57ab884e-558b-11e6-8a84-bae500000078",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "57ab884e-558b-11e6-8a84-bae500000078",
"name": "AttributeName1",
"type": "boolean",
"required": false
}
Заказ покупателя
Получить Заказ покупателя
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Запрос на получение отдельного Заказа покупателя с указанным id.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "34efe2ee-015e-11e6-9464-e4de0000006b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 12:03:05",
"name": "00001",
"description": "Это комментарий к заказу покупателя!",
"externalCode": "CntjFix4hoyZOIhZiULjv2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-13 12:57:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"printed": true,
"published": true,
"sum": 346453701206,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/bc1b4fde-019a-11e6-9464-e4de00000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 214
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/c2ecd338-015e-11e6-9464-e4de0000008f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "AttributeName1",
"type": "long",
"value": "1251252"
}],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 346389501206,
"deliveryPlannedMoment": "2016-04-15 12:58:00",
"payedSum": 365939611804,
"shippedSum": 408739611676,
"invoicedSum": 408739611676
}
Изменить Заказ покупателя
Запрос на обновление Заказа покупателя с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Заказа покупателя, кроме тех, что
помечены Только для чтения в описании атрибутов Заказа покупателя.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдет ошибка.
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Пример запроса на обновление отдельного Заказа покупателя.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "000039",
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на изменение Заказа покупателя с дополнительными полями.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "000039",
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "Обновленный Атрибут заказа",
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "AttributeName1",
"type": "string",
"value": "Обновленный Атрибут заказа"
}
],
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на обновление Заказа покупателя с позициями в теле запроса.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "000039",
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10
},
{
"id": "34f6344f-015e-11e6-9464-e4de0000006d",
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20
},
{
"id": "34f6344f-015e-11e6-9464-e4de0000006e",
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 30
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленного Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Позиции Заказа покупателя
Отдельный ресурс для управления позициями Заказа покупателя. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 1000. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Заказа покупателя
Запрос на получение списка всех позиций данного Заказа покупателя.
| Название |
Тип |
Описание |
| meta |
Meta |
Метаданные о выдаче, |
| context |
Meta |
Метаданные о сотруднике, выполнившем запрос. |
| rows |
Array(Object) |
Массив JSON объектов, представляющих собой позиции Заказа покупателя. |
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| limit |
number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset |
number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение списка всех позиций данного Заказа покупателя.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка позиций отдельного Заказа покупателя.
СвернутьПоказать
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 123050,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=e639e90c-2a99-11e9-ac12-000c0000003e"
}
},
"reserve": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6451e-015e-11e6-9464-e4de0000006d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6451e-015e-11e6-9464-e4de0000006d",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 64200000,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/60fc3826-00d7-11e6-9464-e4de00000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=e639e90c-2a99-11e9-ac12-000c0000003e"
}
},
"reserve": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6551d-015e-11e6-9464-e4de0000006e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6551d-015e-11e6-9464-e4de0000006e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 346347237062,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/56c73633-ffe4-11e5-9464-e4de000000c6",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=e639e90c-2a99-11e9-ac12-000c00001222"
}
},
"reserve": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f66948-015e-11e6-9464-e4de0000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f66948-015e-11e6-9464-e4de0000006f",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 42141094,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/66cc36dc-f7d2-11e5-8a84-bae500000074",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=3c6dc9b8-2842-11e9-ac12-000c00000071"
}
},
"reserve": 1
}
]
}
Создать позицию Заказа покупателя
Запрос на создание новой позиции в Заказе покупателя.
Для успешного создания необходимо в теле запроса указать следующие поля:
- assortment - Ссылка на товар/услугу/серию/модификацию/комплект, которую представляет собой позиция.
Также можно указать поле с именем product, service, consignment, variant, bundle в соответствии с тем,
чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Заказа
- quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Пример создания одной позиции в Заказе покупателя.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"quantity": 49,
"price": 12345,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 19
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданной позиции отдельного Заказа покупателя.
СвернутьПоказать
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/a7a61c8b-acdd-11e6-8a84-bae500000000",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "a7a61c8b-acdd-11e6-8a84-bae500000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 49,
"price": 12345,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3c6dc9b8-2842-11e9-ac12-000c00000071"
}
},
"reward": 2925
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/a7a6c749-acdd-11e6-8a84-bae500000001",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "a7a6c749-acdd-11e6-8a84-bae500000001",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 1020,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=/e64d0a86-2a99-11e9-ac12-000c00000041"
}
},
"reward": 2295
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/a7a6d9cc-acdd-11e6-8a84-bae500000002",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "a7a6d9cc-acdd-11e6-8a84-bae500000002",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 101,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=3b1e1f15-2842-11e9-ac12-000c0000002f"
}
},
"reward": 227
}
]
Пример создания сразу нескольких позиций в Заказе покупателя.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 12,
"price": 300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 11
},
{
"quantity": 3,
"price": 1000,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"inTransit": 1
},
{
"quantity": 404,
"price": 454,
"discount": 200,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 216
}
]'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка созданных позиций отдельного Заказа покупателя.
СвернутьПоказать
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/f389488d-3f71-11e6-8a84-bae50000005f",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "f389488d-3f71-11e6-8a84-bae50000005f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 12,
"price": 300,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=3b1e1f15-2842-11e9-ac12-000c0000002f"
}
},
"shipped": 0,
"inTransit": 11
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/f389521b-3f71-11e6-8a84-bae500000060",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "f389521b-3f71-11e6-8a84-bae500000060",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 3,
"price": 1000,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=e64d0a86-2a99-11e9-ac12-000c00000041"
}
},
"shipped": 0,
"inTransit": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/f3895aa1-3f71-11e6-8a84-bae500000061",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "f3895aa1-3f71-11e6-8a84-bae500000061",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 404,
"price": 454,
"discount": 200,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#feature/edit?id=392c045c-2842-11e9-ac12-000a00000002"
}
},
"shipped": 0,
"inTransit": 216
}
]
Позиция Заказа
Отдельная позиция Заказа с указанным id позиции.
Получить позицию Заказа
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| positionID |
string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа покупателя. |
Запрос на получение отдельной позиции Заказа с указанным id.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельной позиции Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 123050,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=392c045c-2842-11e9-ac12-000a00000002"
}
},
"reserve": 1
}
Изменить позицию Заказа
Запрос на обновление отдельной позиции Заказа. Для обновления позиции нет каких-либо
обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| positionID |
string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа покупателя. |
Пример запроса на обновление отдельной позиции в Заказе покупателя.
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"quantity": 111,
"price": 26332700,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 13
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленной позиции Заказа покупателя.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 111,
"price": 26332700,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=392c045c-2842-11e9-ac12-000a00000002"
}
},
"reserve": 13
}
Удалить позицию
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| positionID |
string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа покупателя. |
Запрос на удаление отдельной позиции Заказа с указанным id.
СвернутьПоказать
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешное удаление позиции Заказа.
Заказ поставщику
Заказы Поставщикам
Средствами JSON API можно создавать и обновлять сведения о Заказах поставщику, запрашивать списки Заказов и сведения по отдельным Заказам Поставщикам. Позициями Заказов можно управлять как в составе отдельного Заказа поставщику, так и отдельно - с помощью специальных ресурсов для управления позициями Заказа. Кодом сущности для Заказа поставщику в составе JSON API является ключевое слово purchaseorder. Больше о Заказах Поставщикам и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| meta |
Meta |
Метаданные Заказа поставщику |
— |
да |
| id |
UUID |
ID Заказа поставщику |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| syncId |
UUID |
ID синхронизации. После заполнения недоступен для изменения |
— |
нет |
| updated |
DateTime |
Момент последнего обновления Заказа поставщику |
Только для чтения |
да |
| deleted |
DateTime |
Момент последнего удаления Заказа поставщику |
Только для чтения |
нет |
| name |
String(255) |
Наименование Заказа поставщику |
— |
да |
| description |
String(4096) |
Комментарий Заказа поставщику |
— |
нет |
| externalCode |
String(255) |
Внешний код Заказа поставщику |
— |
да |
| moment |
DateTime |
Дата Заказа |
— |
да |
| applicable |
Boolean |
Отметка о проведении |
— |
да |
| vatEnabled |
Boolean |
Учитывается ли НДС |
— |
да |
| vatIncluded |
Boolean |
Включен ли НДС в цену |
— |
нет |
| sum |
Int |
Сумма Заказа поставщику в установленной валюте |
Только для чтения |
да |
| rate |
Object |
Валюта. Подробнее тут |
— |
да |
| owner |
Meta |
Владелец (Сотрудник) |
— |
да |
| shared |
Boolean |
Общий доступ |
— |
да |
| group |
Meta |
Отдел сотрудника |
— |
да |
| organization |
Meta |
Метаданные юрлица |
Необходимое при создании |
да |
| agent |
Meta |
Метаданные контрагента |
Необходимое при создании |
да |
| store |
Meta |
Метаданные склада |
— |
да |
| contract |
Meta |
Метаданные договора |
— |
нет |
| state |
Meta |
Метаданные статуса заказа |
— |
нет |
| organizationAccount |
Meta |
Метаданные счета юрлица |
— |
нет |
| agentAccount |
Meta |
Метаданные счета контрагента |
— |
нет |
| attributes |
Array(Object) |
Коллекция метаданных доп. полей. Поля объекта |
— |
нет |
| files |
MetaArray |
Массив метаданных Файлов (Максимальное количество файлов - 100) |
— |
да |
| created |
DateTime |
Дата создания |
Только для чтения |
да |
| printed |
Boolean |
Напечатан ли документ |
Только для чтения |
да |
| published |
Boolean |
Опубликован ли документ |
Только для чтения |
да |
| vatSum |
Float |
Сумма НДС |
Только для чтения |
да |
| positions |
MetaArray |
Метаданные позиций Заказа поставщику |
— |
да |
| deliveryPlannedMoment |
DateTime |
Планируемая дата отгрузки |
— |
нет |
| payedSum |
Float |
Сумма входящих платежей по Заказу |
Только для чтения |
да |
| shippedSum |
Float |
Сумма отгруженного |
Только для чтения |
да |
| invoicedSum |
Float |
Сумма счетов поставщику |
Только для чтения |
да |
| project |
Meta |
Метаданные проекта |
— |
нет |
| waitSum |
Float |
Сумма товаров в пути |
— |
да |
Связи с другими документами
| Название |
Описание |
| customerOrders |
Массив ссылок на связанные заказы покупателей в формате Метаданных |
| invoicesIn |
Массив ссылок на связанные счета поставщиков в формате Метаданных |
| payments |
Массив ссылок на связанные платежи в формате Метаданных |
| supplies |
Массив ссылок на связанные приемки в формате Метаданных |
| internalOrder |
Внутренний заказ, связанный с заказом поставщику, в формате Метаданных |
Позиции Заказа поставщику
Позиции Заказа - это список товаров/услуг/модификаций/серий.
Объект позиции Заказа содержит следующие поля:
| Название |
Тип |
Описание |
Свойство поля в запросе |
Обязательное при ответе |
| id |
UUID |
ID позиции |
Только для чтения |
да |
| accountId |
UUID |
ID учетной записи |
Только для чтения |
да |
| quantity |
Int |
Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе. |
— |
да |
| price |
Float |
Цена товара/услуги в копейках |
— |
да |
| discount |
Int |
Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10% |
— |
да |
| vat |
Int |
НДС, которым облагается текущая позиция |
— |
да |
| assortment |
Meta |
Метаданные товара/услуги/серии/модификации, которую представляет собой позиция |
— |
да |
| pack |
String(255) |
Упаковка товара |
— |
нет |
| shipped |
Int |
Принято |
— |
да |
| wait |
Boolean |
Ожидается данной позиции |
— |
нет |
С позициями можно работать с помощью специальных ресурсов для управления позициями Заказа,
а также в составе отдельного Заказа поставщику. При работе в составе отдельного Заказа поставщику,
вы можете отправлять запросы на создание отдельного Заказа поставщику с включенным в тело запроса
массивом позиций Заказа. Если количество позиций превышает максимально допустимое, то для
дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Заказа поставщику".
Также, при работе в составе отдельного Заказа поставщику, можно отправлять запросы на обновление списка позиций
с включенным в тело запроса массивом позиций Заказа. При этом важно помнить, что коллекция позиций будет
восприниматься как "все позиции Заказа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние
позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Заказов поставщикам можно прочитать здесь
Получить список Заказов Поставщикам
Запрос всех Заказов Поставщикам на данной учетной записи.
Результат: Объект JSON, включающий в себя поля:
| Название |
Тип |
Описание |
| meta |
Meta |
Метаданные о выдаче, |
| context |
Meta |
Метаданные о сотруднике, выполнившем запрос. |
| rows |
Array(Object) |
Массив JSON объектов, представляющих собой Заказы Поставщикам. |
Параметры
| Параметр |
Описание |
| limit |
number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset |
number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search |
string (optional) Example: 0001 Фильтр документов по указанной поисковой строке. |
Получить список Заказов Поставщикам
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Заказов Поставщикам.
СвернутьПоказать
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "172fb2f6-3f70-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 12:42:13",
"name": "00002",
"description": "Описание заказа",
"externalCode": "FfSmVuSKi7h8L-jLADHV80",
"moment": "2016-07-01 12:40:00",
"applicable": true,
"printed": true,
"published": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5900,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/14ae5431-32ca-11e6-8a84-bae50000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-07-15 12:40:00",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 5900
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/403e7ea0-2e63-11e6-8a84-bae500000131",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "403e7ea0-2e63-11e6-8a84-bae500000131",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-10 10:06:46",
"name": "00001",
"externalCode": "pk6fh0NthbBSgrqI931uA0",
"moment": "2016-06-10 10:06:00",
"applicable": true,
"printed": true,
"published": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/403e7ea0-2e63-11e6-8a84-bae500000131/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-06-11 10:06:00",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
]
}
Создать Заказ поставщику
Запрос на создание нового Заказа поставщику.
Обязательные для создания поля:
| Параметр |
Описание |
| name |
номер Заказа поставщику |
| organization |
Ссылка на ваше юрлицо в формате Метаданных |
| agent |
Ссылка на контрагента (поставщику) в формате Метаданных |
Пример создания нового Заказа.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "103034",
"description": "Типичный заказ поставщику",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "404",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": true
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Заказа поставщику.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "22b4caaa-3f74-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:11:11",
"name": "103034",
"description": "Типичный заказ поставщику",
"code": "404",
"externalCode": "s30P0zlwg-1qxSZnRVONF0",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "AttributeName1",
"type": "string",
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "AttributeName2",
"type": "double",
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "AttributeName3",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
Пример запроса на создание Заказа поставщику с позициями в теле запроса.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '{
"name": "777",
"description": "Типичный заказ поставщику",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "404",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": true
}
],
"positions": [
{
"quantity": 12,
"price": 300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 11
},
{
"quantity": 3,
"price": 1000,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"inTransit": 1
},
{
"quantity": 404,
"price": 454,
"discount": 200,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 216
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Заказа поставщику.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "ae7fa9fb-3f74-11e6-8a84-bae500000070",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:15:05",
"name": "777",
"description": "Типичный заказ поставщику",
"code": "404",
"externalCode": "37KNBm71gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"printed": true,
"published": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 176816,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "AttributeName1",
"type": "string",
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "AttributeName2",
"type": "double",
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "AttributeName3",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 5907132
}
Массовое создание и обновление Заказов поставщику
Массовое создание и обновление Заказов поставщику.
В теле запроса нужно передать массив, содержащий JSON представления Заказов поставщику, которые вы хотите создать или обновить.
Обновляемые Заказы поставщику должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Заказов поставщику
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"name": "103034",
"description": "Типичный заказ поставщику",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "404",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": true
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"updated": "2016-07-01 13:15:05",
"name": "777",
"description": "Типичный заказ поставщику, с договором, другой валютой",
"code": "404",
"externalCode": "37KNBm7ф1gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": null,
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": 0.99
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": true
}
],
"vatEnabled": true,
"vatIncluded": false,
"positions": [],
"deliveryPlannedMoment": "2016-02-15 14:12:19"
}
]'
Response 200 (application/json)
Успешный запрос. Результат - массив JSON представлений созданных и обновленных Заказов поставщику.
СвернутьПоказать
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "22b4caaa-3f74-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:11:11",
"name": "103034",
"description": "Типичный заказ поставщику",
"code": "404",
"externalCode": "s30P0zlwg-1qxSZnRVONF0",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "AttributeName1",
"type": "string",
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "AttributeName2",
"type": "double",
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "AttributeName1",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "ae7fa9fb-3f74-11e6-8a84-bae500000070",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:23:26",
"name": "777",
"description": "Типичный заказ поставщику, с договором, другой валютой",
"code": "404",
"externalCode": "37KNBm7ф1gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009/accounts/1485e43e-32ca-11e6-8a84-bae50000000a",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "AttributeName1",
"type": "string",
"value": "AttributeValue1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "AttributeName2",
"type": "double",
"value": 0.99
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "AttributeName3",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2016-08-25 19:55:00",
"printed": true,
"published": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
]
Удалить Заказ поставщику
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
Запрос на удаление Заказа поставщику с указанным id.
СвернутьПоказать
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешное удаление Заказа поставщику.
Массовое удаление Заказов Поставщикам
В теле запроса нужно передать массив, содержащий JSON метаданных Заказов Поставщикам, которые вы хотите удалить.
Запрос на массовое удаление Заказов Поставщикам.
СвернутьПоказать
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/delete"
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
]'
Успешный запрос. Результат - JSON информация об удалении Заказов Поставщикам.
СвернутьПоказать
[
{
"info":"Сущность 'purchaseorder' с UUID: 7944ef04-f831-11e5-7a69-971500188b1 успешно удалена"
},
{
"info":"Сущность 'purchaseorder' с UUID: 7944ef04-f831-11e5-7a69-971500188b2 успешно удалена"
}
]
Метаданные Заказов Поставщикам
Метаданные Заказов Поставщикам
Запрос на получение метаданных Заказов поставщикам. Результат - объект JSON, включающий в себя:
| Параметр |
Описание |
| meta |
Ссылка на метаданные Заказов поставщикам |
| attributes |
Массив объектов доп. полей Заказов поставщикам в формате Метаданных |
| states |
Массив статусов Заказов поставщикам |
| createShared |
создавать новые Заказы поставщикам с меткой "Общий" |
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Заказов Поставщикам
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление доп. полей Заказов поставщикам.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "AttributeName1",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "AttributeName2",
"type": "double",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "AttributeName3",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
},
"id": "11f5becd-3f70-11e6-8a84-bae50000008b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Ожидает отправки",
"color": 10066329,
"stateType": "Regular",
"entityType": "purchaseorder"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр |
Описание |
| id |
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
СвернутьПоказать
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
СвернутьПоказать
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "AttributeName3",
"type": "double",
"required": false
}
Шаблон Заказа поставщику
Шаблон Заказа поставщику
Запрос на получение предзаполненого стандартными значениями шаблона заказа поставщику без связи с каким-либо документом.
Шаблон заказа поставщику
СвернутьПоказать
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/new
-H "Authorization: Basic <Credentials>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json)
Успешный запрос. Результат - JSON представление предзаполненного заказа поставщику.
СвернутьПоказать
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
