Документы Общие сведения Шаблоны документов
Шаблон - предзаполненный стандартными полями JSON-объект, который затем можно использовать для успешного создания документа.
Средствами JSON API можно получать предзаполненные шаблоны документов. Они могут быть предзаполнены как на основе других документов, так и стандартными значениями без связей с другими документами.
Для этого, во всех документах, по которым можно получить шаблон, существует специальный ресурс Шаблон документа
, адрес которого формируется следующим образом:
https://api.moysklad.ru/api/remap/1.2/entity/<ключевое слово для документа>/new
В тело PUT запроса по данному ресурсу нужно передать метаданные документа, на основе которого будет создан шаблон нового документа, либо просто передать пустое тело запроса.
Метаданные должны быть "обернуты" в объект, имя которого есть ключевое слово для документа-основания в JSON API.
Для каждого из данных ресурсов есть примеры запросов и ответов.
Шаблон по токену решения. Существуют отличия в полученных шаблонах при авторизации от пользователя или авторизации от токена решения. В шаблоне полученном при авторизации от решения будет отсутствовать поле owner, group, store, organization. Так же будут отличия между шаблонами на основании документов, полученных при авторизации от пользователя или решения.
На данный момент можно получить шаблоны следующих документы на основании других:
Документ
Основание, на котором он может быть создан
Cчет покупателю (invoiceout)
Заказ покупателя (customerorder), Отгрузка (demand)
Возврат покупателя (salesreturn)
Отгрузка (demand), Розничная продажа (retaildemand)
Возврат поставщику (purchasereturn)
Приемка (supply)
Входящий платеж (paymentin)
Заказ покупателя (customerorder), Возврат поставщику (purchasereturn), Отгрузка (demand), Счет покупателю (invoiceout), Полученный отчет комиссионера (commissionreportin)
Заказ на производство (processingorder)
Техкарта (processingplan)
Заказ поставщику (purchaseorder)
Внутренний заказ (internalorder), Заказ покупателя (customerorder)
Исходящий платеж (paymentout)
Возврат покупателя (salesreturn), Приемка (supply), Счет поставщика (invoicein), Заказ поставщику (purchaseorder), Выданный отчет комиссионера (commissionreportout)
Оприходование (enter)
Инвентаризация(inventory)
Отгрузка (demand)
Заказ покупателя (customerorder), Счет покупателю (invoiceout)
Перемещение (move)
Внутренний заказ (internalorder), Заказ покупателя (customerorder)
Приходный ордер (cashin)
Заказ покупателя (customerorder), Возврат поставщику (purchasereturn), Отгрузка (demand), Счет покупателю (invoiceout), Полученный отчет комиссионера (commissionreportin)
Расходный ордер (cashout)
Возврат покупателя (salesreturn), Приемка (supply), Счет поставщика (invoicein), Заказ поставщику (purchaseorder), Выданный отчет комиссионера (commissionreportout)
Розничная продажа (retaildemand)
Розничная смена (retailshift), Заказ покупателя (customerorder)
Розничный возврат (retailsalesreturn)
Розничная смена (retailshift), Розничная продажа (retaildemand)
Выплата денег (retaildrawercashout)
Розничная смена (retailshift)
Внесение денег (retaildrawercashin)
Розничная смена (retailshift)
Списание (loss)
Возврат покупателя (salesreturn), инвентаризация(inventory)
Счет поставщика (invoicein)
Заказ поставщику (purchaseorder), Приемка (supply)
Счет-фактура полученный (facturein)
Приемка (supply), Исходящий платеж (paymentout)
Счет-фактура выданный (factureout)
Отгрузка (demand), Возврат поставщику (purchasereturn), Входящий платеж (paymentin)
Техоперация (processing)
Заказ на производство (processingorder), Техкарта (processingplan)
В результате PUT запроса по /entity/entityName/new НЕ будет создано нового документа.
Возвращаемый предзаполненный объект является лишь "болванкой" с некоторыми заполненными полями (поля заполняются по той же логике,
что и в аналогичной ситуации в основном интерфейсе), облегчающей создание документа. Он не сохраняется в системе. Этот
объект затем можно передать в теле запроса на создание соответствующего документа и тогда уже документ будет создан, и связан с документом-основанием.
Если послать на данный ресурс пустое тело запроса, то в итоговом шаблоне будут предзаполнены лишь стандартные поля в т.ч. указанные в настройках пользователя
в учетной записи сервиса МойСклад.
В случае если инвентаризация содержит более 500 подходящих позиций, то шаблон списания (loss) и оприходования (entry) будет создан по первым 500 позициям.
С подробностями и примерами по каждому из документов можно ознакомиться в соответствующих разделах документации.
Например, для шаблона отгрузки - смотреть в Шаблонах отгрузки
Контекстный поиск для документов
В JSON API можно осуществлять контекстный поиск среди списка сущностей определенного типа по их строковым полям. Для этого
используется URI параметр фильтрации search .
search
Параметр фильтрации, с помощью которого можно осуществить поиск в списке сущностей. Поиск происходит по основным строковым полям сущностей данного
типа. Результатом поиска будет отсортированный по релевантности список сущностей данного типа, прошедших фильтрацию по переданной поисковой строке. В отличии от фильтрации выборки
с помощью параметра filter , при которой значения проверяются на точное совпадение указанным, при контекстном поиске проверка на совпадение не строгая.
Таким образом, если осуществлять фильтрацию вида ../entity/?filter=name=иван
в отфильтрованную выборку попадут только те сущности, поле name
у которых имеет значение иван
и никакие другие. При контекстном поиске вида ../entity/?search=иван
будут выведены как сущности с name равным
иван
, так и сущности, в имени (или в другом строковом поле) которых иван
просто содержится, например диван
, иванова
и т.п.
Поиск среди документов на соответствие поисковой строке будет осуществлен по следующим полям:
+ по наименованию (name)
+ по описанию (description)
+ по входящему номеру (incomingNumber)
Примеры запросов контекстного поиска (значения должны быть urlencoded):
https://api.moysklad.ru/api/remap/1.2/entity/retaildemand?search=100
https://api.moysklad.ru/api/remap/1.2/entity/salesreturn?search=брак
https://api.moysklad.ru/api/remap/1.2/entity/retailshift?search=ночная
Удаление в корзину
Корзина позволяет избежать риска случайного удаления важных документов. Удаление
в корзину доступно только при наличии у сотрудника соответствующих прав, а также
настроек компании на использовании корзины.
Пример удаления Приемки в корзину
Запрос на удаление Приемки с указанным id в корзину.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/supply/be3a3a0e-370c-11e7-1542-821d00000001/trash"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json)
Успешное удаление Приемки.
Связи документов Привязка документов к документам
Для того чтобы привязать к уже существующему документу другой документ нужно
передать meta привязываемого документа в коллекцию связанных документов или в единственный документ этого типа.
Такие поля присутствуют среди атрибутов документов. В описании сущностей они описаны в секции Связи с другими документами .
Для коллекций каждое поле называется как ключевое слово для типов привязываемых документов во множественном числе. Например поле invoicesOut у отгрузок
отвечает за связи с счетами покупателю. Если вы хотите привязать к отгрузке счет, в это поле, в составе коллекции, нужно положить meta счета покупателя который вы хотите привязать,
Можно привязывать более 1 документа.
Пример привязки 1
Привязка внутреннего заказа к перемещению.
Пример запроса на привязку внутреннего заказа к перемещению.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"internalOrder": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Результат - перемещение с заполненным полем internalOrder.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/d9318341-b0da-11e6-8a84-bae5000000c7" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.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://api.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://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"targetStore" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/85a8e439-b0d8-11e6-8a84-bae500000070" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"internalOrder" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
}
}
}
Пример привязки 2
Привязка счета покупателю к отгрузке.
Пример запроса на привязку счета покупателю к отгрузке.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"invoicesOut": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json)
Результат - отгрузка с новым элементом в коллекции invoicesOut.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"agentAccount" : {
"meta" : {
"href" : "https://api.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://api.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://api.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://api.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata" ,
"type" : "invoiceout" ,
"mediaType" : "application/json"
}
}
]
}
Пример привязки 3
Привязка перемещений к заказу покупателя.
Пример запроса на привязку перемещений к заказу покупателя.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/customerorder/c60e87dc-97b2-11ed-c0a8-a00d00000001"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"moves": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/move/bc8aa8d7-95fa-11ed-c0a8-a00c0000001a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#move/edit?id=bc8aa8d7-95fa-11ed-c0a8-a00c0000001a"
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/move/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#move/edit?id=06406b97-9138-11e6-8a84-bae500000000"
}
}
]
}'
Response 200 (application/json)
Результат - заказ покупателя с новыми элементами в коллекции moves.
Показать Свернуть
{
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"name" : "CustomerOrder 1" ,
"moment" : "2016-11-25 17:33:33" ,
"applicable" : true ,
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/8c33b721-8782-11ed-c0a8-a00c000000b6" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/customerorder/metadata" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"printed" : false ,
"published" : false ,
"files" : {
"rows" : []
},
"positions" : {
"rows" : []
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"payedSum" : 0.0 ,
"shippedSum" : 0.0 ,
"invoicedSum" : 0.0 ,
"moves" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/bc8aa8d7-95fa-11ed-c0a8-a00c0000001a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#move/edit?id=bc8aa8d7-95fa-11ed-c0a8-a00c0000001a"
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/06406b97-9138-11e6-8a84-bae500000000" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#move/edit?id=06406b97-9138-11e6-8a84-bae500000000"
}
}
]
}
Привязка платежей к документам
К некоторым документам в JSON API могут быть привязаны платежи. Платежи бывают 4-х типов: Входящий платеж , Приходный ордер , Исходящий платеж , Расходный ордер .
Документы, к которым могут быть привязаны платежи содержат вложенную коллекцию payments среди атрибутов документа. Платежи в свою очередь содержат коллекцию operations - операции, к которым привязан данный платеж. Для того, чтобы привязать платеж к документу, нужно в запросах
на создание/обновление платежа в составе коллекции operations указать meta документа. Документы в этой коллекции могут иметь разный тип, однако это не значит, что к любому документу можно привязать все 4 типа платежей. Валидные типы платежей определяются самим документом, к которому происходит привязка. К примеру к полученному отчету комиссионера можно привязать только входящий платеж или приходный ордер.
В результате привзяки платежа, в составе коллекции operations платежа появится новый объект, указывающий на документ, а в составе коллекции payments у документа, к которому
привязывается платеж, появится новый элемент ссылающийся на данный платеж.
Пример привязки платежа 1
Привязка входящего платежа к полученному отчету комиссионера.
Пример запроса на привязку платежа к полученному отчету комиссионера.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/paymentin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json)
Результат - входящий платеж с новым элементом в коллекции operations.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/paymentin/94a9f8e9-b30b-11e6-8a84-bae500000017" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/counterparty/b942953e-9128-11e6-8a84-bae500000054" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/a8f3150d-9d39-11e6-8a84-bae500000074" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"vatSum" : 0 ,
"operations" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata" ,
"type" : "commissionreportin" ,
"mediaType" : "application/json"
},
"linkedSum" : 0
}
]
}
Пример привязки платежа 2
Привязка приходного ордера к заказу покупателя.
Пример запроса на привязку приходного ордера к заказу покупателя.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/cashin/7944ef04-f831-11e5-7a69-971500188b19
"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json)
Результат - приходный ордер с новым элементом в коллекции operations.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/cashin/834d731c-b313-11e6-8a84-bae50000008e" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/contract/metadata" ,
"type" : "contract" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"vatSum" : 0 ,
"operations" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/customerorder/metadata" ,
"type" : "customerorder" ,
"mediaType" : "application/json"
},
"linkedSum" : 0
}
]
}
Валюта в документах
Поле rate содержит объект, представляющий валюту в документах.
Атрибуты объекта валюты
Название
Тип
Описание
currency
Meta
Метаданные валютыОбязательное при ответе
Expand
value
Float
Курс валюты в этом документе (содержится в ответе, если значение курса отлично от 1)
Вместо ссылки на валюту можно получить объект валюты целиком с помощью параметра запроса ?expand=rate.currency
.
Пересчет расчетного остатка в инвентаризации
С помощью json api можно пересчитать расчетный остатки в позициях документа "Инвентаризация". В результате, значение поля calculatedQuantity у позиций инвентаризации изменится и документ будет пересохранен.
Пересчет расчетного остатка в инвентаризации
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id инвентаризации.
Пересчитать
Отправить запрос на пересчет расчетных остатков у позиций инвентаризации.
Пример запроса (с пустым телом) на пересчет расчетных остатков у позиций инвентаризации.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/rpc/inventory/7944ef04-f831-11e5-7a69-971500188b19/recalcCalculatedQuantity"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d ''
Response 201 (application/json)
Успешный запрос. Результат - Пустое тело ответа.
Печать документов
Средствами JSON API можно запрашивать печать документов с помощью шаблонов печатных форм .
При запросе на формирование печатной формы сервер (при готовности документа, корректной
печатной форме и правильном формате запроса) отвечает пустым телом ответа с http кодом 303.
В заголовке Location ответа содержится адрес временного расположения готовой к загрузке печатной формы.
Файл во временном расположении доступен для загрузки в течение 5 минут.
Сервер может вернуть ответ 202 и заголовок Location с адресом для опроса готовности печатной формы к загрузке.
Данный вариант будет реализован позже.
Печать документа Запрос на печать
Параметры
Параметр
Описание
id
string
(required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, для которой запрашивается печать.
type
string
(required) Example: demand тип сущности, для которой запрашивается печать.
Запрос на печать отдельного документа по шаблону печатной формы.
Атрибуты запроса
Название
Тип
Описание
template
Meta
Метаданные Шаблона печатиОбязательное при ответе
extension
String(4)
Расширение, в котором нужно напечатать форму. Можно указать xls, pdf, html, ods
Обязательное при ответе
Также можно напечатать комплект документов. Для этого вместо поля template нужно указать поле templates , которое является массивом объектов со следующими полями:
Название
Тип
Описание
template
Meta
Метаданные Шаблона печатиОбязательное при ответе
count
Int
Количество копий печатной формы. От 1 до 10.Обязательное при ответе
Если в запросе будет как поле templates так и поле template (вне элемента массива templates ), произойдет ошибка. В запросе допустимо только 1 из этих полей.
При печати комплектов не нужно указывать поле extension - все комплекты печатаются в pdf .
При печати комплекта, для определенных сущностей можно использовать шаблоны для печати связанных документов.
Так, например, для отгрузки (demand) можно использовать шаблоны:
Счет покупателю
Счет покупателю с печатью и подписью
Заказ покупателя
Счет-фактура выданный
Любой пользовательский шаблон для вышеперечисленных сущностей.
для заказа покупателя:
Любой стандартный (embeddedtemplate) шаблон для отгрузки.
Счет покупателю
Счет покупателю с печатью и подписью
Счет-фактура выданный
Любой пользовательский шаблон для вышеперечисленных сущностей.
для счета покупателю:
Любой стандартный (embeddedtemplate) шаблон для отгрузки.
Заказ покупателя
Счет-фактура выданный
Любой пользовательский шаблон для вышеперечисленных сущностей.
Пример запроса на печать отдельного документа по шаблону печатной формы.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/export/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"template": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/daca545a-1a35-11e7-8a84-bae500000001",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"extension": "xls"
}'
Response 202 Headers
Показать Свернуть
Location : ссылка на статус печати
Content-Type : application/json
Response 303 Headers
Показать Свернуть
Location : ссылка на файл
Content-Type : application/json
Пример запроса на печать комплекта документов. В результате запроса будет напечатан комплект в сумме из 6 печатных форм.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/export/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"templates": [
{
"template": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/daca545a-1a35-11e7-8a84-bae500000001",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"count": 2
},
{
"template": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/factureout/metadata/embeddedtemplate/3d2685b4-cf64-4fd1-87c8-e109966b364b",
"type": "embeddedtemplate",
"mediaType": "application/json"
}
},
"count": 3
},
{
"template": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata/embeddedtemplate/6f3c9a47-6772-4944-9723-92d0d7be2a9c",
"type": "embeddedtemplate",
"mediaType": "application/json"
}
},
"count": 1
}
]
}'
Response 202 Headers
Показать Свернуть
Location : ссылка на статус печати
Content-Type : application/json
Response 303 Headers
Показать Свернуть
Location : ссылка на файл
Content-Type : application/json
Публикация документов
JSON API позволяет опубликовать для общего пользования печатную форму документа, созданную на основе шаблона печатной формы .
Кодом сущности для публикации в составе JSON API является ключевое слово publication .
Работа пользователя с публикациями документов возможна, если есть право на чтение и право печати сущности данного типа.
Публикации доступны только для следующих типов: Заказ покупателя, Счет покупателю, Отгрузка, Заказ поставщику, Счет поставщика, Приемка, Входящий платеж, Приходный ордер, Исходящий платеж, Расходный ордер, Внутренний заказ, Перемещение, Оприходование, Списание, Счет-фактура выданный, Счет-фактура полученный, Возврат поставщику, Возврат покупателя, Выплата денег, Внесение денег, Розничный возврат, Розничная продажа, Договор, Розничная смена, Заказ на производство, Полученный отчет комиссионера, Выданный отчет комиссионера, Инвентаризация, Техоперация.
Публикации Атрибуты сущности
Название
Тип
Описание
meta
Meta
Метаданные ПубликацииОбязательное при ответе
template
Meta
Метаданные Шаблона печатиОбязательное при ответе
Expand
href
URL
Ссылка на страницу ПубликацииОбязательное при ответе
Получить публикации
Параметры
Параметр
Описание
id
string
(required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, по которой получить Публикации.
type
string
(required) Example: demand тип сущности, по которой получить Публикации.
Запрос на получение списка Публикаций по указанному документу.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Публикаций.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003" ,
"type" : "operationpublication" ,
"mediaType" : "application/json"
},
"template" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009" ,
"type" : "customtemplate" ,
"mediaType" : "application/json"
}
},
"href" : "https://mskld.ru/73NIpnAbPr"
}
]
}
Публикация Создать публикацию
Запрос на публикацию документа.
Публикация документа происходит на основании переданного объекта JSON, который должен содержать ссылку на шаблона для печати документа template в формате Метаданных . Если публикация была ранее создана, то ответ будет со статусом 200
.
Параметры
Параметр
Описание
id
string
(required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, по которой получить Публикации.
type
string
(required) Example: demand тип сущности, по которой получить Публикации.
Пример (application/json)
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"template": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление ранее созданной Публикации.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003" ,
"type" : "operationpublication" ,
"mediaType" : "application/json"
},
"template" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009" ,
"type" : "customtemplate" ,
"mediaType" : "application/json"
}
},
"href" : "https://mskld.ru/reu92ZrjCM"
}
Response 201 (application/json)
Успешный запрос. Результат - JSON представление созданной Публикации.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003" ,
"type" : "operationpublication" ,
"mediaType" : "application/json"
},
"template" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009" ,
"type" : "customtemplate" ,
"mediaType" : "application/json"
}
},
"href" : "https://mskld.ru/f00HzRGx8Q"
}
Удалить публикацию
Параметры
Параметр
Описание
id
string
(required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности.
publicationId
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Публикации.
type
string
(required) Example: demand тип сущности.
Запрос на удаление Публикации с указанным id.
Показать Свернуть
curl -X DELETE
"https://api.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 204 (application/json)
Успешное удаление Публикации.
Получить публикацию
Параметры
Параметр
Описание
id
string
(required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности.
publicationId
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Публикации.
type
string
(required) Example: demand тип сущности.
Запрос на получение Публикации с указанным id.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Публикации.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003" ,
"type" : "operationpublication" ,
"mediaType" : "application/json"
},
"template" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009" ,
"type" : "customtemplate" ,
"mediaType" : "application/json"
}
},
"href" : "https://mskld.ru/fuXrdd7Uii"
}
Автозаполнение
Средствами JSON API можно рассчитать значение скидок, цен и ндс для позиций следующих документов:
Заполнение скидок не поддерживает следующие типы:
Заполнение цен не поддерживает Инвентаризация
Заполнение себестоимости поддерживается только для возвратов без основания следующих типов:
- Возврат покупателя
- Розничный возврат
Шаблон автозаполнения Атрибуты сущности
Атрибуты сущности нужно передавать в зависимости от типа документа, для которого будет выполнено автозаполнение. В
соответствие с типом, будут обрабатываться соответствующие поля.
Ниже приводятся поля, которые влияют на заполнение скидок, цен, ндс и себестоимости.
organization - Ссылка на юрлицо в формате Метаданных . Обязателен со значением evaluate_vat
параметра action
agent - Ссылка на контрагента в формате Метаданных .
Обязателен со значениями evaluate_price
, evaluate_discount
параметра action
vatEnabled - Учитывается ли НДС
vatIncluded - Включен ли НДС в цену
rate - Валюта. Если не передано, заполняется валютой учета
store - Ссылка на склад в формате Метаданных . Обязателен со значением evaluate_cost
параметра action
moment - Дата проведения документа. Влияет на расчет себестоимости
positions - Позиции документа
При этом, если помимо вышеперечисленных полей были добавлены другие, не влияющие на заполнение, то они будут присутствовать в
ответе в том же порядке и с теми же значениями.
Примечания
Значения параметра action
можно передавать через запятую.
Если в документе не используется поле agent
, то для расчета цен evaluate_price
и скидок evaluate_discount
используется значение поля organization
.
Позиции документа
Позиции в шаблоне - это список товаров/услуг/модификаций/серий/комплектов.
Объект позиции содержит следующие поля:
quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
price - Цена товара/услуги в копейках.
discount - Процент скидки или наценки.
vat - НДС, которым облагается текущая позиция.
vatEnabled - включен ли НДС для текущей позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = "без НДС". (vat = 0, vatEnabled = false) -> vat = "без НДС", (vat = 0, vatEnabled = true) -> vat = 0%.
assortment - Ссылка на товар/услугу/серию/модификацию/комплект, которую представляет собой позиция, в формате Метаданных
discountedPrice - Цена товара/услуги с учетом скидок и ндс в копейках.
sum - Общая сумма с учетом скидки за указанное количество товара в позиции в копейках. Рассчитывается при передаче поля quantity .
Запрос автозаполения
Запрос заполения полей шаблона.
Результат: Объект JSON, с заполненным шаблоном.
Параметры
Параметр
Описание
action
enum
(optional) Example: evaluate_discount, evaluate_price, evaluate_discount Определяет какую информацию нужно заполнить: цены (evaluate_price), ндс (evaluate_vat), скидки (evaluate_discount) или себестоимость (evaluate_cost). Допустимые значения: evaluate_price, evaluate_discount, evaluate_vat, evaluate_cost
.
Запрос автозаполения цен
Запрос автозаполения с параметром action
со значением evaluate_price
. Требуется заполнение поля agent (или organization , если поле agent отсутствует).
Заполняет поле цены товара price (если явно не передано) ценой переданного в поле agent контрагента,
а также поле discountedPrice , с учетом рассчитанной или переданной скидки discount
(принимается за 0, если значение отсутствует) и НДС vat (не учитывается, если пустое, поле vatEnabled
имеет значение false
или vatIncluded имеет значение true
). Если передано поле quantity ,
то будет рассчитано поле sum . При вычислениях используется переданный rate
.
Запрос автозаполения цен
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/wizard/demand?action=evaluate_price"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '
{
"agent":{
"meta":{
"href":"https://api.moysklad.ru/api/remap/1.2/entity/counterparty/eff93a94-c03a-11ea-c0a8-f00c0000001f",
"metadataHref":"https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type":"counterparty",
"mediaType":"application/json",
"uuidHref":"https://online.moysklad.ru/app/#company/edit?id=eff93a94-c03a-11ea-c0a8-f00c0000001f"
}
},
"positions":[
{
"assortment":{
"meta":{
"href":"https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a",
"metadataHref":"https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type":"product",
"mediaType":"application/json",
"uuidHref":"https://online.moysklad.ru/app/#good/edit?id=46628fb5-c1c8-11ea-c0a8-f00c00000018"
}
},
"quantity":12
},
{
"assortment":{
"meta":{
"href":"https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e",
"metadataHref":"https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type":"product",
"mediaType":"application/json",
"uuidHref":"https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
},
"discount":20
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление заполненного шаблона документа.
Показать Свернуть
{
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/eff93a94-c03a-11ea-c0a8-f00c0000001f" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#company/edit?id=eff93a94-c03a-11ea-c0a8-f00c0000001f"
}
},
"positions" : [
{
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=46628fb5-c1c8-11ea-c0a8-f00c00000018"
}
},
"price" : 3300.0 ,
"discountedPrice" : 3300.0 ,
"quantity" : 12.0 ,
"sum" : 39600.0
},
{
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
},
"price" : 3300.0 ,
"discountedPrice" : 2640.0 ,
"discount" : 20.0
}
]
}
Запрос автозаполения скидок
Запрос автозаполения с параметром action
со значением evaluate_discount
. Требуется заполнение поля agent (или organization , если поле agent отсутствует).
Заполняет поле скидки discount (если явно не передано) суммой применимых к данному товару активных скидок
переданного в поле agent контрагента.
Запрос автозаполения скидок
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/wizard/demand?action=evaluate_discount"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '
{
"agent":{
"meta":{
"href":"https://api.moysklad.ru/api/remap/1.2/entity/counterparty/eff93a94-c03a-11ea-c0a8-f00c0000001f",
"metadataHref":"https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type":"counterparty",
"mediaType":"application/json",
"uuidHref":"https://online.moysklad.ru/app/#company/edit?id=eff93a94-c03a-11ea-c0a8-f00c0000001f"
}
},
"positions":[
{
"assortment":{
"meta":{
"href":"https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a",
"metadataHref":"https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type":"product",
"mediaType":"application/json",
"uuidHref":"https://online.moysklad.ru/app/#good/edit?id=46628fb5-c1c8-11ea-c0a8-f00c00000018"
}
},
"quantity":12
},
{
"assortment":{
"meta":{
"href":"https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e",
"metadataHref":"https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type":"product",
"mediaType":"application/json",
"uuidHref":"https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
}
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление заполненного шаблона документа.
Показать Свернуть
{
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/eff93a94-c03a-11ea-c0a8-f00c0000001f" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#company/edit?id=eff93a94-c03a-11ea-c0a8-f00c0000001f"
}
},
"positions" : [
{
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=46628fb5-c1c8-11ea-c0a8-f00c00000018"
}
},
"quantity" : 12.0 ,
"discount" : 65.0
},
{
"discount" : 40.0 ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
}
}
]
}
Запрос автозаполения НДС
Запрос автозаполения с параметром action
со значением evaluate_vat
. Требуется заполнение поля organization .
Заполняет поле vatEnabled на основе того, является ли переданная в поле organization организация плательщиком
НДС и поля vat у позиций значением из карточки товара, если организация - плательщик НДС.
Запрос автозаполения НДС
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/wizard/demand?action=evaluate_vat"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '
{
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/44055d92-bf76-11ea-c0a8-f01000000070",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=44055d92-bf76-11ea-c0a8-f01000000070"
}
},
"vatEnabled": "true",
"rate": {
"currency": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/currency/44126ea6-bf76-11ea-c0a8-f01000000077",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=44126ea6-bf76-11ea-c0a8-f01000000077"
}
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=466222d6-c1c8-11ea-c0a8-f00c00000018"
}
},
"quantity": 12
},
{
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
}
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление заполненного шаблона документа.
Показать Свернуть
{
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/44055d92-bf76-11ea-c0a8-f01000000070" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#mycompany/edit?id=44055d92-bf76-11ea-c0a8-f01000000070"
}
},
"vatEnabled" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/44126ea6-bf76-11ea-c0a8-f01000000077" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#currency/edit?id=44126ea6-bf76-11ea-c0a8-f01000000077"
}
}
},
"positions" : [
{
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=466222d6-c1c8-11ea-c0a8-f00c00000018"
}
},
"quantity" : 12.0 ,
"vat" : 10 ,
"vatEnabled" : true
},
{
"vat" : 18 ,
"vatEnabled" : true ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
}
}
]
}
Запрос автозаполения себестоимости
Запрос автозаполения с параметром action
со значением evaluate_cost
. Выполняется только для Возвратов Покупателя и Розничных Возвратов без основания . Требуется заполнение поля store .
Заполняет поля cost у позиций значением себестоимости, рассчитанным по FIFO на момент moment . Если поле moment не указано, то себестоимость рассчитывается на текущую дату.
Запрос автозаполения себестоимости
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/wizard/salesreturn?action=evaluate_cost"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '
{
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/16a3019e-1204-11eb-c0a8-300c00000072",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=16a3019e-1204-11eb-c0a8-300c00000072"
}
},
"moment": "2020-10-20 17:45:00.000",
"positions": [
{
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=466222d6-c1c8-11ea-c0a8-f00c00000018"
}
}
},
{
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
}
}
]
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление заполненного шаблона документа.
Показать Свернуть
{
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/16a3019e-1204-11eb-c0a8-300c00000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#warehouse/edit?id=16a3019e-1204-11eb-c0a8-300c00000072"
}
},
"moment" : "2020-10-20 17:45:00.000" ,
"positions" : [
{
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/46628fb5-c1c8-11ea-c0a8-f00c0000001a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=466222d6-c1c8-11ea-c0a8-f00c00000018"
}
},
"cost" : 1200.0
},
{
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/bb989405-bf9e-11ea-c0a8-f0100000000e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=bb96904c-bf9e-11ea-c0a8-f0100000000c"
}
},
"cost" : 3500.0
}
]
}
Внесение денег
Средствами JSON API можно создавать и обновлять сведения о Внесениях денег, запрашивать списки Внесений денег и сведения по отдельным Внесениям денег. Кодом сущности для Внесения денег в составе JSON API является ключевое слово retaildrawercashin . Больше о Внесениях денег и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке .
Внесения денег Атрибуты сущности
Название
Тип
Фильтрация
Описание
accountId
UUID
=
!=
ID учетной записиОбязательное при ответе
Только для чтения
agent
Meta
=
!=
Метаданные контрагентаОбязательное при ответе
Expand
Необходимо при создании
applicable
Boolean
=
!=
Отметка о проведенииОбязательное при ответе
attributes
Array(Object)
Операторы доп. полей
Коллекция метаданных доп. полей. Поля объекта
created
DateTime
=
!=
<
>
<=
>=
Дата созданияОбязательное при ответе
Только для чтения
deleted
DateTime
=
!=
<
>
<=
>=
Момент последнего удаления Внесения денегТолько для чтения
description
String(4096)
=
!=
~
~=
=~
Комментарий Внесения денег
externalCode
String(255)
=
!=
~
~=
=~
Внешний код Внесения денегОбязательное при ответе
files
MetaArray
Метаданные массива Файлов (Максимальное количество файлов - 100)Обязательное при ответе
Expand
group
Meta
=
!=
Отдел сотрудникаОбязательное при ответе
Expand
id
UUID
=
!=
ID Внесения денегОбязательное при ответе
Только для чтения
meta
Meta
Метаданные Внесения денегОбязательное при ответе
moment
DateTime
=
!=
<
>
<=
>=
Дата документаОбязательное при ответе
name
String(255)
=
!=
~
~=
=~
Наименование Внесения денегОбязательное при ответе
organization
Meta
=
!=
Метаданные юрлицаОбязательное при ответе
Expand
Необходимо при создании
owner
Meta
=
!=
Владелец (Сотрудник)Expand
printed
Boolean
=
!=
Напечатан ли документОбязательное при ответе
Только для чтения
published
Boolean
=
!=
Опубликован ли документОбязательное при ответе
Только для чтения
rate
Object
Валюта. Подробнее тут Обязательное при ответе
shared
Boolean
=
!=
Общий доступОбязательное при ответе
state
Meta
=
!=
Метаданные статуса Внесения денегExpand
sum
Int
=
!=
<
>
<=
>=
Сумма Внесения денег в копейкахОбязательное при ответе
Только для чтения
syncId
UUID
=
!=
ID синхронизации. После заполнения недоступен для изменения
updated
DateTime
=
!=
<
>
<=
>=
Момент последнего обновления Внесения денегОбязательное при ответе
Только для чтения
Связи с другими документами
Название
Описание
retailShift
Ссылка на розничную смену, в рамках которой было выполнено Внесение денег в формате Метаданных . По данному полю можно фильтровать используя операторы = и !=. Необходимое
Получить Внесения денег
Запрос на получение всех Внесений денег на данной учетной записи.
Параметры
Параметр
Описание
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://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Внесений денег.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "179dd832-960c-11e6-8a84-bae5000000dc" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 17:55:36" ,
"name" : "00001" ,
"description" : "Внесение" ,
"externalCode" : "2Rqfj4sNhkS98TU70DNRw1" ,
"moment" : "2016-10-19 17:55:00" ,
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 112312000 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2266b7e1-960c-11e6-8a84-bae5000000df" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "2266b7e1-960c-11e6-8a84-bae5000000df" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 17:55:54" ,
"name" : "00002" ,
"description" : "Коммент" ,
"externalCode" : "Rk3nJ4y1hw3O3b9qJ6xN30" ,
"moment" : "2016-10-19 17:55:00" ,
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 2000 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
}
]
}
Создать Внесение денег
Запрос на создание Внесения денег.
Обязательные для создания поля:
organization - Ссылка на ваше юрлицо в формате Метаданных
agent - Ссылка на сотрудника, совершившего Внесение, в формате Метаданных
retailShift - Ссылка на розничную смену в формате Метаданных
Пример создания нового Внесения денег.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"agent": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"sum": 100500,
"description": "Новое внесение через API"
}'
Response 200
Успешный запрос. Результат - массив JSON представлений созданного и обновленного Внесения денег.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/b1bd1d12-960c-11e6-8a84-bae500000009" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "b1bd1d12-960c-11e6-8a84-bae500000009" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 17:59:54" ,
"name" : "00003" ,
"description" : "Новое внесение через API" ,
"externalCode" : "fhlISdMTgl8C-lh9nLfIN0" ,
"moment" : "2016-10-19 17:59:54" ,
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 100500 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
}
Массовое создание и обновление Внесений денег
Массовое создание и обновление Внесений денег.
В теле запроса нужно передать массив, содержащий JSON представления Внесений денег, которые вы хотите создать или обновить.
Обновляемые Внесения денег должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Внесений денег
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"agent": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"sum": 100500,
"description": "Новое внесение через API"
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"name": "0000004",
"sum": 700,
"applicable": false
}
]'
Response 200 (application/json)
Успешный запрос. Результат - массив JSON представлений созданных и обновленных Внесений денег.
Показать Свернуть
[
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/b1bd1d12-960c-11e6-8a84-bae500000009" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "b1bd1d12-960c-11e6-8a84-bae500000009" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 17:59:54" ,
"name" : "00003" ,
"description" : "Новое внесение через API" ,
"externalCode" : "fhlISdMTgl8C-lh9nLfIN0" ,
"moment" : "2016-10-19 17:59:54" ,
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 100500 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "179dd832-960c-11e6-8a84-bae5000000dc" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 18:03:00" ,
"name" : "0000004" ,
"description" : "Внесение" ,
"externalCode" : "2Rqfj4sNhkS98TU70DNRw1" ,
"moment" : "2016-10-19 17:55:00" ,
"applicable" : false ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 700 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
}
]
Удалить Внесение денег
Запрос на удаление Внесения денег с указанным id.
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Внесения денег.
Удалить Внесение денег
Показать Свернуть
curl -X DELETE
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос.
Массовое удаление Внесений денег
В теле запроса нужно передать массив, содержащий JSON метаданных Внесений денег, которые вы хотите удалить.
Запрос на массовое удаление Внесений денег.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/delete"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/7944ef04-f831-11e5-7a69-971500188b1",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/7944ef04-f831-11e5-7a69-971500188b2",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
}
}
]'
Успешный запрос. Результат - JSON информация об удалении Внесений денег.
Показать Свернуть
[
{
"info" : "Сущность 'retaildrawercashin' с UUID: 7944ef04-f831-11e5-7a69-971500188b1 успешно удалена"
},
{
"info" : "Сущность 'retaildrawercashin' с UUID: 7944ef04-f831-11e5-7a69-971500188b2 успешно удалена"
}
]
Запрос на получение метаданных Внесений денег. Результат - объект JSON, включающий в себя:
Параметр
Описание
meta
Ссылка на метаданные Внесений денег
attributes
Массив объектов доп. полей Внесений денег в формате Метаданных
states
Массив статусов Внесений денег
createShared
создавать новые Внесения денег с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями .
Метаданные Внесений денег
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление доп. полей Внесений денег.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"mediaType" : "application/json"
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "5290a290-0313-11e6-9464-e4de00000020" ,
"name" : "AttributeName1" ,
"type" : "boolean" ,
"required" : false
}
],
"states" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/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" : "retaildrawercashin"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/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" : "retaildrawercashin"
}
],
"createShared" : false
}
Отдельное доп. поле
Параметры
Параметр
Описание
id
string
(required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля.
Запрос на получение информации по отдельному дополнительному полю.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "5290a290-0313-11e6-9464-e4de00000020" ,
"name" : "AttributeName1" ,
"type" : "boolean" ,
"required" : false
}
Шаблон Внесения денег Шаблон Внесения денег
Запрос на получение предзаполненого стандартными значениями шаблона Внесения денег без связи с каким-либо документом.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/new"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json)
Успешный запрос. Результат - JSON представление предзаполненного Внесения денег.
Показать Свернуть
{
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
}
}
Шаблон Внесения денег на основе
Запрос на получение предзаполненного Внесения денег на основе розничной смены.
В результате запроса, будет создан предзаполненный шаблон Внесения денег на основе переданной
розничной смены.
Внимание! Не забывайте, что поле retailShift должно быть написано с большой S.
Запрос на создание Внесения денег на основе розничной смены.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/new"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление предзаполненного Внесения денег.
Показать Свернуть
{
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
}
Внесение денег Получить Внесение денег
Запрос на получение отдельного Внесения денег с указанным id.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Внесения денег с указанным id.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "179dd832-960c-11e6-8a84-bae5000000dc" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 17:55:36" ,
"name" : "00001" ,
"description" : "Внесение" ,
"externalCode" : "2Rqfj4sNhkS98TU70DNRw1" ,
"moment" : "2016-10-19 17:55:00" ,
"applicable" : true ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 112312000 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
}
Изменить Внесение денег
Запрос на обновление Внесения денег.
Пример обновления Внесения денег.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"name": "0000004",
"sum": 700,
"applicable": false
}'
Response 200
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata" ,
"type" : "retaildrawercashin" ,
"mediaType" : "application/json"
},
"id" : "179dd832-960c-11e6-8a84-bae5000000dc" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-10-19 18:03:00" ,
"name" : "0000004" ,
"description" : "Внесение" ,
"externalCode" : "2Rqfj4sNhkS98TU70DNRw1" ,
"moment" : "2016-10-19 17:55:00" ,
"applicable" : false ,
"created" : "2016-08-25 19:55:00" ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 700 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"retailShift" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/retailshift/metadata" ,
"type" : "retailshift" ,
"mediaType" : "application/json"
}
}
}
Внутренний заказ
Средствами JSON API можно создавать и обновлять сведения о Внутренних заказах, запрашивать списки Внутренних заказов и сведения по отдельным Внутренним заказам. Позициями Внутренних заказов можно управлять как в составе отдельного заказа, так и с помощью специальных ресурсов для управления позициями. Кодом сущности для Внутреннего заказа в составе JSON API является ключевое слово internalorder .
Внутренние заказы Атрибуты сущности
Название
Тип
Фильтрация
Описание
accountId
UUID
=
!=
ID учетной записиОбязательное при ответе
Только для чтения
applicable
Boolean
=
!=
Отметка о проведенииОбязательное при ответе
attributes
Array(Object)
Операторы доп. полей
Коллекция метаданных доп. полей. Поля объекта Только для чтения
code
String(255)
=
!=
~
~=
=~
Код Внутреннего заказа
created
DateTime
=
!=
<
>
<=
>=
Дата созданияОбязательное при ответе
Только для чтения
deleted
DateTime
=
!=
<
>
<=
>=
Момент последнего удаления Внутреннего заказаТолько для чтения
deliveryPlannedMoment
DateTime
Планируемая дата приемки
description
String(4096)
=
!=
~
~=
=~
Комментарий Внутреннего заказа
externalCode
String(255)
=
!=
~
~=
=~
Внешний код Внутреннего заказаОбязательное при ответе
files
MetaArray
Метаданные массива Файлов (Максимальное количество файлов - 100)Обязательное при ответе
Expand
group
Meta
=
!=
Отдел сотрудникаОбязательное при ответе
Expand
id
UUID
=
!=
ID Внутреннего заказаОбязательное при ответе
Только для чтения
meta
Meta
Метаданные Внутреннего заказаОбязательное при ответе
Только для чтения
moment
DateTime
=
!=
<
>
<=
>=
Дата документаОбязательное при ответе
moves
Array(Object)
Коллекция метаданных на связанные заказы перемещенияОбязательное при ответе
name
String(255)
=
!=
~
~=
=~
Наименование Внутреннего заказаОбязательное при ответе
Необходимо при создании
organization
Meta
=
!=
Метаданные юрлицаОбязательное при ответе
Expand
Необходимо при создании
owner
Meta
=
!=
Владелец (Сотрудник)Expand
positions
MetaArray
Метаданные позиций Внутреннего заказаОбязательное при ответе
Только для чтения
Expand
printed
Boolean
=
!=
Напечатан ли документОбязательное при ответе
Только для чтения
project
Meta
=
!=
Метаданные проектаExpand
published
Boolean
=
!=
Опубликован ли документОбязательное при ответе
Только для чтения
purchaseOrders
Array(Object)
Коллекция метаданных на связанные заказы поставщикуОбязательное при ответе
rate
Object
Валюта. Подробнее тут Обязательное при ответе
shared
Boolean
=
!=
Общий доступОбязательное при ответе
Только для чтения
state
Meta
=
!=
Метаданные статуса Внутреннего заказаExpand
store
Meta
Метаданные складаExpand
sum
Int
=
!=
<
>
<=
>=
Сумма Внутреннего заказа в копейкахОбязательное при ответе
Только для чтения
syncId
UUID
=
!=
ID синхронизации. После заполнения недоступен для измененияТолько для чтения
updated
DateTime
=
!=
<
>
<=
>=
Момент последнего обновления Внутреннего заказаОбязательное при ответе
Только для чтения
vatEnabled
Boolean
Учитывается ли НДСОбязательное при ответе
vatIncluded
Boolean
Включен ли НДС в цену
vatSum
Float
Сумма НДСОбязательное при ответе
Только для чтения
Позиции Внутреннего заказа
Позиции Внутреннего заказа - это список товаров/услуг/модификаций/серий.
Объект позиции Внутреннего заказа содержит следующие поля:
Название
Тип
Описание
accountId
UUID
ID учетной записиОбязательное при ответе
Только для чтения
assortment
Meta
Метаданные товара/услуги/серии/модификации, которую представляет собой позицияОбязательное при ответе
Expand
id
UUID
ID позицииОбязательное при ответе
Только для чтения
pack
Object
Упаковка Товара. Подробнее тут
price
Float
Цена товара/услуги в копейкахОбязательное при ответе
quantity
Float
Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.Обязательное при ответе
vat
Int
НДС, которым облагается текущая позицияОбязательное при ответе
vatEnabled
Boolean
Включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = "без НДС". (vat = 0, vatEnabled = false) -> vat = "без НДС", (vat = 0, vatEnabled = true) -> vat = 0%.Обязательное при ответе
С позициями можно работать с помощью специальных ресурсов для управления позициями Внутреннего заказа ,
а также в составе отдельного Внутреннего заказа. При работе в составе отдельного Внутреннего заказа,
вы можете отправлять запросы на создание отдельного Внутреннего заказа с включенным в тело запроса
массивом позиций Внутреннего заказа. Если количество позиций превышает максимально допустимое, то для
дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Внутреннего заказа".
Также, при работе в составе отдельного Внутреннего заказа, можно отправлять запросы на обновление списка позиций
с включенным в тело запроса массивом позиций Внутреннего заказа. При этом важно помнить, что коллекция позиций будет
восприниматься как "все позиции Внутреннего заказа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние
позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Внутренних заказов можно прочитать здесь
Получить Внутренние заказы
Параметры
Параметр
Описание
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://api.moysklad.ru/api/remap/1.2/entity/internalorder"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Внутренних заказов.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "31d58bde-b2fd-11e6-8a84-bae500000068" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-25 13:52:01" ,
"name" : "00002" ,
"description" : "Комментарий" ,
"externalCode" : "00KNqzWbjDRhZ1A0411hS2" ,
"moment" : "2016-11-25 13:50:00" ,
"applicable" : true ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
},
"value" : 1
},
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"deliveryPlannedMoment" : "2016-11-30 13:50:00"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "64e426af-b0d8-11e6-8a84-bae500000064" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-22 21:04:24" ,
"name" : "00001" ,
"externalCode" : "80QQopc4h8yBc0LnmTPpT3" ,
"moment" : "2016-11-22 20:23:00" ,
"applicable" : true ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 5 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"moves" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/a3b68a79-b0dc-11e6-8a84-bae5000000cd" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json"
}
}
]
}
]
}
Создать Внутренний заказ
Запрос на создание нового Внутреннего заказа.
Обязательные для создания поля:
organization - Ссылка на ваше юрлицо в формате Метаданных
Пример создания нового Внутреннего заказа.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "000222",
"description": "Мой Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"sum": 0,
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/variant/fc635ded-acf7-11e6-8a84-bae500000075",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Внутреннего заказа.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "eb75f6b8-b2ff-11e6-8a84-bae500000000" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-25 14:11:31" ,
"name" : "000222" ,
"description" : "Мой Комментарий" ,
"externalCode" : "00KNqzWbjDRhZ1A0411ss1231hS2" ,
"moment" : "2016-11-25 13:52:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
},
"value" : 63.45
},
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"deliveryPlannedMoment" : "2016-11-30 13:50:00"
}
Шаблон Внутреннего заказа Шаблон Внутреннего заказа
Запрос на получение шаблона Внутреннего заказа.
Пример создания нового Внутреннего заказа.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/new"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json)
Успешный запрос. Результат - JSON представление предзаполненного шаблона Внутреннего заказа.
Показать Свернуть
{
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"moment" : "2016-11-25 14:59:18" ,
"applicable" : true ,
"printed" : true ,
"published" : true ,
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"positions" : {
"rows" : []
},
"vatEnabled" : true ,
"vatIncluded" : true
}
Массовое создание и обновление Внутренних заказов
Массовое создание и обновление Внутренних заказов.
В теле запроса нужно передать массив, содержащий JSON представления Внутренних заказов, которые вы хотите создать или обновить.
Обновляемые Внутренние заказы должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Внутренних заказов
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/new"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"owner": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "000222",
"description": "Мой Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"sum": 0,
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/variant/fc635ded-acf7-11e6-8a84-bae500000075",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"owner": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "700222",
"description": "Мой обновленный Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 2230.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-12-30 13:52:00"
}
]'
Response 200 (application/json)
Успешный запрос. Результат - массив JSON представлений созданных и обновленных Внутренних заказов.
Показать Свернуть
[
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "eb75f6b8-b2ff-11e6-8a84-bae500000000" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-25 14:11:31" ,
"name" : "000222" ,
"description" : "Мой Комментарий" ,
"externalCode" : "00KNqzWbjDRhZ1A0411ss1231hS2" ,
"moment" : "2016-11-25 13:52:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
},
"value" : 63.45
},
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"deliveryPlannedMoment" : "2016-11-30 13:50:00"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "64e426af-b0d8-11e6-8a84-bae500000064" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : true ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-25 14:48:02" ,
"name" : "700222" ,
"description" : "Мой обновленный Комментарий" ,
"externalCode" : "00KNqzWbjDRhZ1A0411ss1231hS2" ,
"moment" : "2016-11-25 13:52:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
},
"value" : 63.45
},
"sum" : 2230 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"deliveryPlannedMoment" : "2016-12-30 13:52:00" ,
"moves" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/a3b68a79-b0dc-11e6-8a84-bae5000000cd" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json"
}
}
]
}
]
Удалить Внутренний заказ
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Внутреннего заказа.
Запрос на удаление Внутреннего заказа с указанным id.
Показать Свернуть
curl -X DELETE
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b1"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешное удаление Внутреннего заказа.
Массовое удаление Внутренних заказов
В теле запроса нужно передать массив, содержащий JSON метаданных Внутренних заказов, которые вы хотите удалить.
Запрос на массовое удаление Внутренних заказов.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/delete"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b1",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b2",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
]'
Успешный запрос. Результат - JSON информация об удалении Внутренних заказов.
Показать Свернуть
[
{
"info" : "Сущность 'internalorder' с UUID: 7944ef04-f831-11e5-7a69-971500188b1 успешно удалена"
},
{
"info" : "Сущность 'internalorder' с UUID: 7944ef04-f831-11e5-7a69-971500188b2 успешно удалена"
}
]
Запрос на получение метаданных Внутренних заказов. Результат - объект JSON, включающий в себя:
Параметр
Описание
meta
Ссылка на метаданные Внутренних заказов
attributes
Массив объектов доп. полей Внутренних заказов в формате Метаданных
states
Массив статусов Внутренних заказов
createShared
создавать новые Внутренние заказы с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями .
Метаданные Внутренних заказов
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление метаданных Внутренних заказов.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"mediaType" : "application/json"
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/attributes/68d142e7-b300-11e6-8a84-bae50000008b" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "68d142e7-b300-11e6-8a84-bae50000008b" ,
"name" : "Доп поле внут заказа" ,
"type" : "string" ,
"required" : false
}
],
"states" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
},
"id" : "f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"name" : "OMG" ,
"color" : 10066329 ,
"stateType" : "Regular" ,
"entityType" : "internalorder"
}
],
"createShared" : false
}
Отдельное доп. поле
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля.
Запрос на получение информации по отдельному дополнительному полю.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/attributes/68d142e7-b300-11e6-8a84-bae50000008b" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "68d142e7-b300-11e6-8a84-bae50000008b" ,
"name" : "Доп поле внут заказа" ,
"type" : "string" ,
"required" : false
}
Внутренний заказ Получить Внутренний заказ
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Внутреннего заказа.
Запрос на получение отдельного Внутреннего заказа с указанным id.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Внутреннего заказа.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "31d58bde-b2fd-11e6-8a84-bae500000068" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-25 13:52:01" ,
"name" : "00002" ,
"description" : "Комментарий" ,
"externalCode" : "00KNqzWbjDRhZ1A0411hS2" ,
"moment" : "2016-11-25 13:50:00" ,
"applicable" : true ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
},
"value" : 1
},
"sum" : 0 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"deliveryPlannedMoment" : "2016-11-30 13:50:00" ,
"moves" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/3aa6f577-b2ff-11e6-8a84-bae500000070" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json"
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/3fe38e12-b2ff-11e6-8a84-bae500000077" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json"
}
}
],
"purchaseOrders" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/purchaseorder/4a29b74e-b2ff-11e6-8a84-bae500000084" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata" ,
"type" : "purchaseorder" ,
"mediaType" : "application/json"
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/purchaseorder/45353c47-b2ff-11e6-8a84-bae50000007e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata" ,
"type" : "purchaseorder" ,
"mediaType" : "application/json"
}
}
]
}
Изменить Внутренний заказ
Запрос на обновление Внутреннего заказа с указанным id.
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Внутреннего заказа.
Пример запроса на обновление отдельного Внутреннего заказа.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "700222",
"description": "Мой обновленный Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 2230.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-12-30 13:52:00"
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленного Внутреннего заказа.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata" ,
"type" : "internalorder" ,
"mediaType" : "application/json"
},
"id" : "64e426af-b0d8-11e6-8a84-bae500000064" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : true ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-11-25 14:48:02" ,
"name" : "700222" ,
"description" : "Мой обновленный Комментарий" ,
"externalCode" : "00KNqzWbjDRhZ1A0411ss1231hS2" ,
"moment" : "2016-11-25 13:52:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
},
"value" : 63.45
},
"sum" : 2230 ,
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"project" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/project/metadata" ,
"type" : "project" ,
"mediaType" : "application/json"
}
},
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"vatSum" : 0 ,
"deliveryPlannedMoment" : "2016-12-30 13:52:00" ,
"moves" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/move/a3b68a79-b0dc-11e6-8a84-bae5000000cd" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/move/metadata" ,
"type" : "move" ,
"mediaType" : "application/json"
}
}
]
}
Позиции Внутреннего заказа
Отдельный ресурс для управления позициями Внутреннего заказа. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает 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 Отступ в выдаваемом списке сущностей.
search
string
(optional) Example: 0001 Фильтр документов по указанной поисковой строке.
Получить позиции Внутреннего заказа
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка позиций отдельного Внутреннего заказа.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/05379d42-b305-11e6-8a84-bae500000008" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json"
},
"id" : "05379d42-b305-11e6-8a84-bae500000008" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 2230.0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.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"
}
}
}
]
}
Создать позиции Внутреннего заказа
Запрос на создание новой позиции во Внутреннем заказе.
Для успешного создания необходимо в теле запроса указать следующие поля:
assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция.
Также можно указать поле с именем service , consignment , variant в соответствии с тем,
чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Внутреннего заказа
quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Одновременно можно создать как одну так и несколько позиций Внутреннего заказа. Все созданные данным запросом позиции
будут добавлены к уже существующим.
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Внутреннего заказа.
Пример создания позиций во Внутреннем заказе.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"quantity": 1,
"price": 100.0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 12,
"price": 200.0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 3,
"price": 2230.0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданной позиции отдельного Внутреннего заказа.
Показать Свернуть
[
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/705ff11b-b305-11e6-8a84-bae50000000c" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json"
},
"id" : "705ff11b-b305-11e6-8a84-bae50000000c" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 100.0 ,
"vat" : 10 ,
"vatEnabled" : true ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.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"
}
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/705ffca0-b305-11e6-8a84-bae50000000d" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json"
},
"id" : "705ffca0-b305-11e6-8a84-bae50000000d" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"quantity" : 12 ,
"price" : 200.0 ,
"vat" : 18 ,
"vatEnabled" : true ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.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"
}
}
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/706006cd-b305-11e6-8a84-bae50000000e" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json"
},
"id" : "706006cd-b305-11e6-8a84-bae50000000e" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"quantity" : 3 ,
"price" : 2230.0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.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"
}
}
}
]
Позиция Внутреннего заказа Получить позицию
Параметры
Параметр
Описание
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://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельной позиции Внутреннего заказа.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json"
},
"id" : "7944ef04-f831-11e5-7a69-971500188b20" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"quantity" : 12 ,
"price" : 200.0 ,
"vat" : 18 ,
"vatEnabled" : true ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.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"
}
}
}
Изменить позицию
Запрос на обновление отдельной позиции Внутреннего заказа.
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Внутреннего заказа.
positionID
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b20 id позиции Внутреннего заказа.
Пример запроса на обновление отдельной позиции во Внутреннем заказе.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"quantity": 2,
"price": 500.0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленной позиции заказа.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b20" ,
"type" : "internalorderposition" ,
"mediaType" : "application/json"
},
"id" : "7944ef04-f831-11e5-7a69-971500188b20" ,
"accountId" : "b8b74698-9128-11e6-8a84-bae500000001" ,
"quantity" : 2 ,
"price" : 500.0 ,
"vat" : 18 ,
"vatEnabled" : true ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068" ,
"metadataHref" : "https://api.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"
}
}
}
Удалить позицию
Параметры
Параметр
Описание
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://api.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешное удаление позиции Внутреннего заказа.
Массовое удаление позиций
Параметры
Параметр
Описание
id
string
(required) Example: 7623cd58-684d-11ee-ac12-000c0000009e id Внутреннего заказа.
Запрос на массовое удаление позиций Внутреннего заказа.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7623cd58-684d-11ee-ac12-000c0000009e/positions/delete"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7623cd58-684d-11ee-ac12-000c0000009e/positions/7fce2da5-684d-11ee-ac12-000c000000a2",
"type": "internalorderposition",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/internalorder/7623cd58-684d-11ee-ac12-000c0000009e/positions/7fce37a5-684d-11ee-ac12-000c000000a3",
"type": "internalorderposition",
"mediaType": "application/json"
}
}
]'
Response 200 (application/json)
Успешное удаление позиций Внутреннего заказа.
Возврат покупателя
Средствами JSON API можно создавать и обновлять сведения о Возвратах покупателей, запрашивать списки Возвратов покупателей и сведения по отдельным Возвратам покупателей. Позициями Возвратов покупателей можно управлять как в составе отдельного Возврата, так и отдельно - с помощью специальных ресурсов для управления позициями Возврата покупателя. Кодом сущности для Возврата покупателя в составе JSON API является ключевое слово salesreturn .
Возвраты покупателей Атрибуты сущности
Название
Тип
Фильтрация
Описание
accountId
UUID
=
!=
ID учетной записиОбязательное при ответе
Только для чтения
Change-handler
agent
Meta
=
!=
Метаданные контрагентаОбязательное при ответе
Expand
Change-handler
agentAccount
Meta
Метаданные счета контрагентаExpand
Change-handler
applicable
Boolean
=
!=
Отметка о проведенииОбязательное при ответе
Change-handler
attributes
Array(Object)
Операторы доп. полей
Коллекция метаданных доп. полей. Поля объекта Change-handler
code
String(255)
=
!=
~
~=
=~
Код Возврата Покупателя
contract
Meta
=
!=
Метаданные договораExpand
Change-handler
created
DateTime
=
!=
<
>
<=
>=
Дата созданияОбязательное при ответе
Только для чтения
Change-handler
deleted
DateTime
=
!=
<
>
<=
>=
Момент последнего удаления Возврата ПокупателяТолько для чтения
description
String(4096)
=
!=
~
~=
=~
Комментарий Возврата ПокупателяChange-handler
externalCode
String(255)
=
!=
~
~=
=~
Внешний код Возврата ПокупателяОбязательное при ответе
Change-handler
files
MetaArray
Метаданные массива Файлов (Максимальное количество файлов - 100)Обязательное при ответе
Expand
group
Meta
=
!=
Отдел сотрудникаОбязательное при ответе
Expand
id
UUID
=
!=
ID Возврата ПокупателяОбязательное при ответе
Только для чтения
Change-handler
meta
Meta
Метаданные Возврата ПокупателяОбязательное при ответе
Change-handler
moment
DateTime
=
!=
<
>
<=
>=
Дата документаОбязательное при ответе
Change-handler
name
String(255)
=
!=
~
~=
=~
Наименование Возврата ПокупателяОбязательное при ответе
Change-handler
organization
Meta
=
!=
Метаданные юрлицаОбязательное при ответе
Expand
Необходимо при создании
Change-handler
organizationAccount
Meta
Метаданные счета юрлицаExpand
Change-handler
owner
Meta
=
!=
Владелец (Сотрудник)Expand
positions
MetaArray
Метаданные позиций Возврата ПокупателяОбязательное при ответе
Expand
Change-handler
printed
Boolean
=
!=
Напечатан ли документОбязательное при ответе
Только для чтения
project
Meta
=
!=
Метаданные проектаExpand
Change-handler
published
Boolean
=
!=
Опубликован ли документОбязательное при ответе
Только для чтения
rate
Object
Валюта. Подробнее тут Обязательное при ответе
Change-handler
salesChannel
Meta
=
!=
Метаданные канала продажExpand
shared
Boolean
=
!=
Общий доступОбязательное при ответе
state
Meta
=
!=
Метаданные статуса Возврата ПокупателяExpand
Change-handler
store
Meta
=
!=
Метаданные складаОбязательное при ответе
Expand
Необходимо при создании
Change-handler
sum
Int
=
!=
<
>
<=
>=
Сумма Возврата Покупателя в копейкахОбязательное при ответе
Только для чтения
Change-handler
syncId
UUID
=
!=
ID синхронизации. После заполнения недоступен для изменения
updated
DateTime
=
!=
<
>
<=
>=
Момент последнего обновления Возврата ПокупателяОбязательное при ответе
Только для чтения
Change-handler
vatEnabled
Boolean
Учитывается ли НДСОбязательное при ответе
Change-handler
vatIncluded
Boolean
Включен ли НДС в цену Change-handler
vatSum
Float
Сумма НДСОбязательное при ответе
Change-handler
Связи с другими документами
Название
Описание
demand
Ссылка на отгрузку, по которой произошел возврат в формате Метаданных Поле является необходимым для возврата с основанием.
losses
Массив ссылок на связанные списания в формате Метаданных
payments
Массив ссылок на связанные платежи в формате Метаданных
payedSum
Сумма исходящих платежей по возврату покупателя
factureOut
Ссылка на Счет-фактуру выданный, с которым связан этот возврат, в формате Метаданных
Позиции Возврата покупателя
Позиции Возврата покупателей - это список товаров/услуг/модификаций/серий/комплектов.
Объект позиции Возврата покупателей содержит следующие поля:
Название
Тип
Описание
accountId
UUID
ID учетной записиОбязательное при ответе
Только для чтения
Change-handler
assortment
Meta
Метаданные товара/услуги/серии/модификации, которую представляет собой позицияОбязательное при ответе
Expand
Change-handler
cost
Int
Себестоимость (выводится, если документ был создан без основания)
country
Meta
Метаданные СтраныExpand
discount
Int
Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%Обязательное при ответе
Change-handler
gtd
Object
ГТД. Подробнее тут
id
UUID
ID позицииОбязательное при ответе
Только для чтения
Change-handler
pack
Object
Упаковка Товара. Подробнее тут Change-handler
price
Float
Цена товара/услуги в копейкахОбязательное при ответе
Change-handler
quantity
Float
Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.Обязательное при ответе
Change-handler
slot
Meta
Ячейка на складе. Подробнее тут Expand
things
Array(String)
Серийные номера. Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете. В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
vat
Int
НДС, которым облагается текущая позицияОбязательное при ответе
Change-handler
vatEnabled
Boolean
Включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = "без НДС". (vat = 0, vatEnabled = false) -> vat = "без НДС", (vat = 0, vatEnabled = true) -> vat = 0%.Обязательное при ответе
Change-handler
С позициями можно работать с помощью специальных ресурсов для управления позициями Возврата покупателей ,
а также в составе отдельного Возврата покупателей. При работе в составе отдельного Возврата покупателей,
вы можете отправлять запросы на создание отдельного Возврата покупателей с включенным в тело запроса
массивом позиций Возврата покупателей. Если количество позиций превышает максимально допустимое, то для
дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Возврата покупателей".
Также, при работе в составе отдельного Возврата покупателей, можно отправлять запросы на обновление списка позиций
с включенным в тело запроса массивом позиций Возврата покупателей. При этом важно помнить, что коллекция позиций будет
восприниматься как "все позиции Возврата покупателей" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние
позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Возвратов покупателейых возвратов можно прочитать здесь
Получить Возвраты покупателей
Запрос всех Возвратов покупателей на данной учетной записи.
Результат: Объект 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://api.moysklad.ru/api/remap/1.2/entity/salesreturn"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Возвратов покупателей.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json" ,
"size" : 2 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "90f337d1-3f80-11e6-8a84-bae5000000ac" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 14:40:10" ,
"name" : "00001" ,
"externalCode" : "PDJ7P5kVhEWomlQtd67up2" ,
"moment" : "2016-07-01 14:39:00" ,
"applicable" : true ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 25100 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 6 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "9b83cb6b-3f80-11e6-8a84-bae5000000bb" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 14:40:27" ,
"name" : "00002" ,
"externalCode" : "3ZaZZNCVhYzDgTunfKsTy3" ,
"moment" : "2016-07-01 14:40:00" ,
"applicable" : true ,
"printed" : true ,
"published" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 1100 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"salesChannel" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/saleschannel/56446e7f-3633-11ec-ac13-000d00000000" ,
"type" : "saleschannel" ,
"mediaType" : "application/json"
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/d8937c31-3eb7-11e6-8a84-bae500000066" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
}
]
}
Создать Возврат покупателя
Обязательные поля при создании нового Возврата покупателей:
organization - Ссылка на ваше юрлицо в формате Метаданных
store - Ссылка на склад в формате Метаданных
demand - Ссылка на отгрузку, по которой произошел возврат в формате Метаданных , обязательное поле только для возврата по основанию
agent - Ссылка на контрагента в формате Метаданных
Контрагент, указанный в запросе на создание возврата, должен совпадать с контрагентом, указанном в документе,
по которому создается возврат.
При создании возврата:
При создании возврата без основания поле demand указывать не нужно
Контрагент в возврате и в документе, по которому он создается, должны совпадать
Валюта и юрлицо в возврате и в документе так же должны совпадать
При создании возврата на основании другого документа, позиции передаваемые в коллекции positions , должны соответствовать позициям документа-основания. Можно задать количество товара в позиции, но не больше, чем в документе-основании. Нельзя передавать позиции, которых нет в документе-основании и менять значение поля price .
Пример создания нового Возврата покупателя.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"name": "0003",
"description": "Гневный возврат бракованного товара",
"code": "k123e21451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": false,
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "отломана деталь"
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": true
}
],
"positions": [
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"demand": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданного Возврата покупателя.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 15:16:37" ,
"name" : "0003" ,
"description" : "Гневный возврат бракованного товара" ,
"code" : "k123e21451k" ,
"externalCode" : "w214t2141f" ,
"moment" : "2017-11-21 14:37:00" ,
"applicable" : false ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"name" : "AttributeName1" ,
"type" : "string" ,
"value" : "отломана деталь"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "50463893-3f81-11e6-8a84-bae5000000de" ,
"name" : "AttributeName2" ,
"type" : "boolean" ,
"value" : true
}
],
"vatEnabled" : true ,
"vatIncluded" : true ,
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
}
Массовое создание и обновление Возвратов покупателя
Массовое создание и обновление Возвратов покупателя.
В теле запроса нужно передать массив, содержащий JSON представления Возвратов покупателя, которые вы хотите создать или обновить.
Обновляемые Возвраты покупателя должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Возвратов покупателя
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"name": "0003",
"description": "Гневный возврат бракованного товара",
"code": "k123e21451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": false,
"organization": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "отломана деталь"
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": true
}
],
"positions": [
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"demand": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"updated": "2016-07-01 15:16:37",
"name": "00033",
"description": "Гневный возврат бракованного робота",
"code": "k12eer3e21rre451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": true,
"state": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "отломана нога"
}
]
}
]'
Response 200 (application/json)
Успешный запрос. Результат - массив JSON представлений созданных и обновленных Возвратов покупателя.
Показать Свернуть
[
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 15:16:37" ,
"name" : "0003" ,
"description" : "Гневный возврат бракованного товара" ,
"code" : "k123e21451k" ,
"externalCode" : "w214t2141f" ,
"moment" : "2017-11-21 14:37:00" ,
"applicable" : false ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"name" : "AttributeName1" ,
"type" : "string" ,
"value" : "отломана деталь"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "50463893-3f81-11e6-8a84-bae5000000de" ,
"name" : "AttributeName2" ,
"type" : "boolean" ,
"value" : true
}
],
"vatEnabled" : true ,
"vatIncluded" : true ,
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 15:27:18" ,
"name" : "00033" ,
"description" : "Гневный возврат бракованного робота" ,
"code" : "k12eer3e21rre451k" ,
"externalCode" : "w214t2141f" ,
"moment" : "2017-11-21 14:37:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"salesChannel" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/saleschannel/56446e7f-3633-11ec-ac13-000d00000000" ,
"type" : "saleschannel" ,
"mediaType" : "application/json"
}
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"name" : "AttributeName1" ,
"type" : "string" ,
"value" : "отломана нога"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "50463893-3f81-11e6-8a84-bae5000000de" ,
"name" : "AttributeName2" ,
"type" : "boolean" ,
"value" : true
}
],
"vatEnabled" : true ,
"vatIncluded" : true ,
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
}
]
Удалить Возврат покупателя
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей.
Запрос на удаление Возврата покупателей с указанным id.
Показать Свернуть
curl -X DELETE
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешное удаление Возврата покупателей.
Массовое удаление Возвратов покупателей
В теле запроса нужно передать массив, содержащий JSON метаданных Возвратов покупателей, которые вы хотите удалить.
Запрос на массовое удаление Возвратов покупателей.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/delete"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b1",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b2",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
]'
Успешный запрос. Результат - JSON информация об удалении Возвратов покупателей.
Показать Свернуть
[
{
"info" : "Сущность 'salesreturn' с UUID: 7944ef04-f831-11e5-7a69-971500188b1 успешно удалена"
},
{
"info" : "Сущность 'salesreturn' с UUID: 7944ef04-f831-11e5-7a69-971500188b2 успешно удалена"
}
]
Запрос на получение метаданных Возвратов покупателей. Результат - объект JSON, включающий в себя:
Параметр
Описание
meta
Ссылка на метаданные Возвратов покупателей
attributes
Массив объектов доп. полей Возвратов покупателей в формате Метаданных
states
Массив статусов Возвратов покупателей
createShared
создавать новые Возвраты покупателей с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями .
Метаданные Возвратов покупателей
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление доп. полей Возвратов покупателей.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"mediaType" : "application/json"
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"name" : "AttributeName1" ,
"type" : "string" ,
"required" : false
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "50463893-3f81-11e6-8a84-bae5000000de" ,
"name" : "AttributeName2" ,
"type" : "boolean" ,
"required" : false
}
],
"states" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073ae24-3f81-11e6-8a84-bae5000000e2" ,
"type" : "state" ,
"mediaType" : "application/json"
},
"id" : "7073ae24-3f81-11e6-8a84-bae5000000e2" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"name" : "Открыт" ,
"color" : 10066329 ,
"stateType" : "Regular" ,
"entityType" : "salesreturn"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3" ,
"type" : "state" ,
"mediaType" : "application/json"
},
"id" : "7073b255-3f81-11e6-8a84-bae5000000e3" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"name" : "Выполнен" ,
"color" : 15280409 ,
"stateType" : "Regular" ,
"entityType" : "salesreturn"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b5aa-3f81-11e6-8a84-bae5000000e4" ,
"type" : "state" ,
"mediaType" : "application/json"
},
"id" : "7073b5aa-3f81-11e6-8a84-bae5000000e4" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"name" : "Выполнен Частично" ,
"color" : 15106326 ,
"stateType" : "Regular" ,
"entityType" : "salesreturn"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b99b-3f81-11e6-8a84-bae5000000e5" ,
"type" : "state" ,
"mediaType" : "application/json"
},
"id" : "7073b99b-3f81-11e6-8a84-bae5000000e5" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"name" : "На оформлении" ,
"color" : 34617 ,
"stateType" : "Regular" ,
"entityType" : "salesreturn"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073bd44-3f81-11e6-8a84-bae5000000e6" ,
"type" : "state" ,
"mediaType" : "application/json"
},
"id" : "7073bd44-3f81-11e6-8a84-bae5000000e6" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"name" : "Оформлен" ,
"color" : 9245744 ,
"stateType" : "Regular" ,
"entityType" : "salesreturn"
}
],
"createShared" : false
}
Отдельное доп. поле
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля.
Запрос на получение информации по отдельному дополнительному полю.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельного доп. поля.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "50463893-3f81-11e6-8a84-bae5000000de" ,
"name" : "AttributeName1" ,
"type" : "boolean" ,
"required" : false
}
Шаблон Возврата покупателя Шаблон Возврата покупателя
Запрос на получение предзаполненого стандартными значениями шаблона возврата покупателя без связи с каким-либо документом.
Создание шаблона возврата покупателя с пустым телом запроса
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/new"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json)
Успешный запрос. Результат - JSON представление предзаполненного возврата покупателя.
Показать Свернуть
{
"applicable" : false ,
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 0 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : []
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"payedSum" : 0
}
Шаблон Возврата покупателя на основе
Запрос на получение предзаполненного шаблона возврата покупателя на основе переданной отгрузки.
В ответ на запрос вернется предзаполненный шаблон возврата покупателя, который
затем можно будет использовать для создания нового возврата с помощью POST запроса.
Пример запроса на создание шаблона возврата покупателя на основе отгрузки.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/new"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"demand": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление предзаполненного Возврата покупателя.
Показать Свернуть
{
"applicable" : false ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 0 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : []
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
}
Возврат покупателя Получить Возврат покупателя
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей.
Запрос на получение отдельного Возврата покупателей с указанным id.
Показать Свернуть
curl -X GET
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление Возврата покупателей с указанным id.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "90f337d1-3f80-11e6-8a84-bae5000000ac" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 14:40:10" ,
"name" : "00001" ,
"externalCode" : "PDJ7P5kVhEWomlQtd67up2" ,
"moment" : "2016-07-01 14:39:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 25100 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"salesChannel" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/saleschannel/56446e7f-3633-11ec-ac13-000d00000000" ,
"type" : "saleschannel" ,
"mediaType" : "application/json"
}
},
"vatEnabled" : true ,
"vatIncluded" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 6 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 0
}
Изменить Возврат покупателя
Запрос на обновление Возврата покупателей с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Возврата покупателей, кроме тех, что
помечены Только для чтения
в описании атрибутов Возврата покупателей .
При обновлении поля organization нужно также обновить поле organizationAccount иначе произойдет ошибка.
Контрагент должен совпадать с контрагентом, указанным в документе, по которому создается возврат.
При обновлении возврата:
Нельзя изменять следующие поля: agentAccount , agent , demand
Нельзя выставить валюту отличную от валюты в документе
Нельзя добавить позиции, отсутствующие среди позиций документа.
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей.
Пример запроса на обновление Возврата покупателей.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"updated": "2016-07-01 15:16:37",
"name": "00033",
"description": "Гневный возврат бракованного робота",
"code": "k12eer3e21rre451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": true,
"state": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"value": "отломана нога"
}
],
"positions": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленного Возврата покупателей.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata" ,
"type" : "salesreturn" ,
"mediaType" : "application/json"
},
"id" : "a8b8e1e3-3f85-11e6-8a84-bae50000008d" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-07-01 15:27:18" ,
"name" : "00033" ,
"description" : "Гневный возврат бракованного робота" ,
"code" : "k12eer3e21rre451k" ,
"externalCode" : "w214t2141f" ,
"moment" : "2017-11-21 14:37:00" ,
"applicable" : true ,
"rate" : {
"currency" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/currency/metadata" ,
"type" : "currency" ,
"mediaType" : "application/json"
}
}
},
"sum" : 0 ,
"organization" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/organization/metadata" ,
"type" : "organization" ,
"mediaType" : "application/json"
}
},
"store" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/store/metadata" ,
"type" : "store" ,
"mediaType" : "application/json"
}
},
"agent" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/counterparty/metadata" ,
"type" : "counterparty" ,
"mediaType" : "application/json"
}
},
"state" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3" ,
"type" : "state" ,
"mediaType" : "application/json"
}
},
"organizationAccount" : {
"meta" : {
"href" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005" ,
"type" : "account" ,
"mediaType" : "application/json"
}
},
"salesChannel" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/saleschannel/56446e7f-3633-11ec-ac13-000d00000000" ,
"type" : "saleschannel" ,
"mediaType" : "application/json"
}
},
"attributes" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "43dd9fd7-3f81-11e6-8a84-bae5000000db" ,
"name" : "AttributeName1" ,
"type" : "string" ,
"value" : "отломана нога"
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de" ,
"type" : "attributemetadata" ,
"mediaType" : "application/json"
},
"id" : "50463893-3f81-11e6-8a84-bae5000000de" ,
"name" : "AttributeName2" ,
"type" : "boolean" ,
"value" : true
}
],
"vatEnabled" : true ,
"vatIncluded" : true ,
"created" : "2007-02-07 17:16:41" ,
"printed" : true ,
"published" : true ,
"positions" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 1 ,
"limit" : 1000 ,
"offset" : 0
}
},
"demand" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/demand/metadata" ,
"type" : "demand" ,
"mediaType" : "application/json"
}
},
"payedSum" : 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://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка позиций Возврата покупателей.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json" ,
"size" : 6 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/90f3f201-3f80-11e6-8a84-bae5000000ad" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "90f3f201-3f80-11e6-8a84-bae5000000ad" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 900 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118" ,
"metadataHref" : "https://api.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://api.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/country/metadata" ,
"type" : "country" ,
"mediaType" : "application/json"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/90f3fc5f-3f80-11e6-8a84-bae5000000ae" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "90f3fc5f-3f80-11e6-8a84-bae5000000ae" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/90f41291-3f80-11e6-8a84-bae5000000af" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "90f41291-3f80-11e6-8a84-bae5000000af" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/90f41a94-3f80-11e6-8a84-bae5000000b0" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "90f41a94-3f80-11e6-8a84-bae5000000b0" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 8600.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/58f32700-3303-11e6-8a84-bae50000853c" ,
"metadataHref" : "https://api.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"
}
},
"gtd" : {
"name" : "12345678/121217/1212321"
},
"country" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/country/metadata" ,
"type" : "country" ,
"mediaType" : "application/json"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/90f4218b-3f80-11e6-8a84-bae5000000b1" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "90f4218b-3f80-11e6-8a84-bae5000000b1" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/67aa1d09-3d19-11e6-8a84-bae50000000b" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/90f427d1-3f80-11e6-8a84-bae5000000b2" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "90f427d1-3f80-11e6-8a84-bae5000000b2" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 16500.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=3c3c1618-2842-11e9-ac12-000c0000006f"
}
},
"cost" : 10
}
]
}
Создать Позицию
Запрос на создание новой позиции в Возврате покупателя.
Для успешного создания необходимо в теле запроса указать следующие поля:
assortmet - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция.
Также можно указать поле с именем service , consignment , variant в соответствии с тем,
чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Возврата покупателей .
quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Одновременно можно создать как одну так и несколько позиций Возврата покупателей. Все созданные данным запросом позиции
будут добавлены к уже существующим.
Нельзя создавать позиции, отличные от позиций в документе, по которому создается возврат. Допустимо только
отличие в quantity позиций (количество в позиции в возврате м.б. меньше или равно количеству в позиции в документе).
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей.
Пример запроса на создание позиций в Возврате покупателя.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"quantity": 900,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 11
},
{
"quantity": 1,
"price": 8600.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/58f32700-3303-11e6-8a84-bae50000853c",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 13
},
{
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/67aa1d09-3d19-11e6-8a84-bae50000000b",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 15
},
{
"quantity": 1,
"price": 16500.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 17
}
]'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление созданных позиций.
Показать Свернуть
[
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/ea8f2771-3f82-11e6-8a84-bae50000007f" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "ea8f2771-3f82-11e6-8a84-bae50000007f" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 900 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata" ,
"type" : "product" ,
"mediaType" : "application/json" ,
"uuidHref" : "https://online.moysklad.ru/app/#good/edit?id=3c3c1618-2842-11e9-ac12-000c0000006f"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/ea8f2f2e-3f82-11e6-8a84-bae500000080" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "ea8f2f2e-3f82-11e6-8a84-bae500000080" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 10
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/ea8f35ca-3f82-11e6-8a84-bae500000081" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "ea8f35ca-3f82-11e6-8a84-bae500000081" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 11
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/ea8f3bce-3f82-11e6-8a84-bae500000082" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "ea8f3bce-3f82-11e6-8a84-bae500000082" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 8600.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/58f32700-3303-11e6-8a84-bae50000853c" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 13
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/ea8f41a9-3f82-11e6-8a84-bae500000083" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "ea8f41a9-3f82-11e6-8a84-bae500000083" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/67aa1d09-3d19-11e6-8a84-bae50000000b" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 15
},
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/ea8f477b-3f82-11e6-8a84-bae500000084" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "ea8f477b-3f82-11e6-8a84-bae500000084" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 16500.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 17
}
]
Позиция Возврата покупателя Получить Позицию
Параметры
Параметр
Описание
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://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление отдельной позиции Возврата покупателей.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "34f6344f-015e-11e6-9464-e4de0000006" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 0.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 10
}
Изменить Позицию
Запрос на обновление отдельной позиции Возврата покупателей.
При обновлении отдельной позиции в возврате можно только изменить количество данной позиции.
Причем это количество должно быть в пределах , где n - кол-во данной позиции в документе, по которому создан возврат.
Параметры
Параметр
Описание
id
string
(required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей.
positionID
string
(required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата покупателей.
Пример запроса на обновление отдельной позиции в Возврате покупателя.
Показать Свернуть
curl -X PUT
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '{
"quantity": 1,
"price": 16500.0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 100
}'
Response 200 (application/json)
Успешный запрос. Результат - JSON представление обновленной позиции Возврата покупателей.
Показать Свернуть
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c" ,
"type" : "salesreturnposition" ,
"mediaType" : "application/json"
},
"id" : "34f6344f-015e-11e6-9464-e4de0000006c" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"quantity" : 1 ,
"price" : 16500.0 ,
"discount" : 0 ,
"vat" : 0 ,
"vatEnabled" : false ,
"assortment" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39" ,
"metadataHref" : "https://api.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"
}
},
"cost" : 100
}
Удалить позицию
Параметры
Параметр
Описание
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://api.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешное удаление позиции Возврата покупателей.
Массовое удаление позиций
Параметры
Параметр
Описание
id
string
(required) Example: 3e1c03bb-684f-11ee-ac12-000c000000b0 id Возврата покупателей
Запрос на массовое удаление позиций Возврата покупателей.
Показать Свернуть
curl -X POST
"https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/3e1c03bb-684f-11ee-ac12-000c000000b0/positions/delete"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/3e1c03bb-684f-11ee-ac12-000c000000b0/positions/7fce2da5-684d-11ee-ac12-000c000000a2",
"type": "internalorderposition",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://api.moysklad.ru/api/remap/1.2/entity/salesreturn/3e1c03bb-684f-11ee-ac12-000c000000b0/positions/7fce37a5-684d-11ee-ac12-000c000000a3",
"type": "internalorderposition",
"mediaType": "application/json"
}
}
]'
Response 200 (application/json)
Успешное удаление позиций Возврата покупателей.
Возврат поставщику
Средствами JSON API можно создавать и обновлять сведения о Возвратах поставщикам, запрашивать списки Возвратов поставщикам и сведения по отдельным Возвратам поставщикам. Позициями Возвратов поставщикам можно управлять как в составе отдельного Возврата, так и отдельно - с помощью специальных ресурсов для управления позициями Возврата поставщику. Кодом сущности для Возврата поставщику в составе JSON API является ключевое слово purchasereturn .
Возвраты поставщикам Атрибуты сущности
Название
Тип
Фильтрация
Описание
accountId
UUID
=
!=
ID учетной записиОбязательное при ответе
Только для чтения
agent
Meta
=
!=
Метаданные контрагентаОбязательное при ответе
Expand
Необходимо при создании
agentAccount
Meta
Метаданные счета контрагентаExpand
applicable
Boolean
=
!=
Отметка о проведенииОбязательное при ответе
attributes
Array(Object)
Операторы доп. полей
Коллекция метаданных доп. полей. Поля объекта
code
String(255)
=
!=
~
~=
=~
Код Возврата поставщику
contract
Meta
=
!=
Метаданные договораExpand
created
DateTime
=
!=
<
>
<=
>=
Дата созданияОбязательное при ответе
Только для чтения
deleted
DateTime
=
!=
<
>
<=
>=
Момент последнего удаления Возврата поставщикуТолько для чтения
description
String(4096)
=
!=
~
~=
=~
Комментарий Возврата поставщику
externalCode
String(255)
=
!=
~
~=
=~
Внешний код Возврата поставщикуОбязательное при ответе
files
MetaArray
Метаданные массива Файлов (Максимальное количество файлов - 100)Обязательное при ответе
Expand
group
Meta
=
!=
Отдел сотрудникаОбязательное при ответе
Expand
id
UUID
=
!=
ID Возврата поставщикуОбязательное при ответе
Только для чтения
meta
Meta
Метаданные Возврата поставщикуОбязательное при ответе
moment
DateTime
=
!=
<
>
<=
>=
Дата документаОбязательное при ответе
name
String(255)
=
!=
~
~=
=~
Наименование Возврата поставщикуОбязательное при ответе
organization
Meta
=
!=
Метаданные юрлицаОбязательное при ответе
Expand
organizationAccount
Meta
Метаданные счета юрлицаExpand
owner
Meta
=
!=
Владелец (Сотрудник)Expand
printed
Boolean
=
!=
Напечатан ли документОбязательное при ответе
Только для чтения
project
Meta
=
!=
Метаданные проектаExpand
published
Boolean
=
!=
Опубликован ли документОбязательное при ответе
Только для чтения
rate
Object
Валюта. Подробнее тут Обязательное при ответе
shared
Boolean
=
!=
Общий доступОбязательное при ответе
state
Meta
=
!=
Метаданные статуса Возврата поставщикуExpand
store
Meta
=
!=
Метаданные складаОбязательное при ответе
Expand
Необходимо при создании
sum
Int
=
!=
<
>
<=
>=
Сумма Возврата поставщику в копейкахОбязательное при ответе
Только для чтения
syncId
UUID
=
!=
ID синхронизации. После заполнения недоступен для изменения
updated
DateTime
=
!=
<
>
<=
>=
Момент последнего обновления Возврата поставщикуОбязательное при ответе
Только для чтения
vatEnabled
Boolean
Учитывается ли НДСОбязательное при ответе
vatIncluded
Boolean
Включен ли НДС в цену
vatSum
Float
Сумма НДСОбязательное при ответе
Связи с другими документами
Название
Описание
positions
Ссылка на позиции Возврата поставщику в формате Метаданных
supply
Ссылка на приемку, по которой произошел возврат в формате Метаданных Поле является необходимым для возврата с основанием.
factureOut
Ссылка на Счет-фактуру выданный в формате Метаданных
factureIn
Ссылка на Счет-фактуру полученный в формате Метаданных
payedSum
Сумма входящих платежей по возврату поставщику
payments
Массив ссылок на связанные платежи в формате Метаданных
Позиции Возврата поставщику
Позиции Возврата поставщику - это список товаров/услуг/модификаций/серий.
Объект позиции Возврата поставщику содержит следующие поля:
Название
Тип
Описание
accountId
UUID
ID учетной записиОбязательное при ответе
Только для чтения
assortment
Meta
Метаданные товара/услуги/серии/модификации, которую представляет собой позицияОбязательное при ответе
Expand
discount
Float
Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%Обязательное при ответе
id
UUID
ID позицииОбязательное при ответе
Только для чтения
pack
Object
Упаковка Товара. Подробнее тут
price
Float
Цена товара/услуги в копейкахОбязательное при ответе
quantity
Float
Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учет по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.Обязательное при ответе
slot
Meta
Ячейка на складе. Подробнее тут Expand
things
Array(String)
Серийные номера. Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете. В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
vat
Int
НДС, которым облагается текущая позицияОбязательное при ответе
vatEnabled
Boolean
Включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = "без НДС". (vat = 0, vatEnabled = false) -> vat = "без НДС", (vat = 0, vatEnabled = true) -> vat = 0%.Обязательное при ответе
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Возврата поставщику ,
а также в составе отдельного Возврата поставщику. При работе в составе отдельного Возврата поставщику,
вы можете отправлять запросы на создание отдельного Возврата поставщику с включенным в тело запроса
массивом позиций Возврата поставщику. Если количество позиций превышает максимально допустимое, то для
дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Возврата поставщику".
Также, при работе в составе отдельного Возврата поставщику, можно отправлять запросы на обновление списка позиций
с включенным в тело запроса массивом позиций Возврата поставщику. При этом важно помнить, что коллекция позиций будет
восприниматься как "все позиции Возврата поставщику" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние
позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Возвратов поставщикамых возвратов можно прочитать здесь
Получить Возвраты поставщикам
Запрос всех Возвратов поставщикам на данной учетной записи.
Результат: Объект 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://api.moysklad.ru/api/remap/1.2/entity/purchasereturn"
-H "Authorization: Basic <Credentials>"
-H "Accept-Encoding: gzip"
Response 200 (application/json)
Успешный запрос. Результат - JSON представление списка Возвратов поставщикам.
Показать Свернуть
{
"context" : {
"employee" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/context/employee" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
}
},
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/purchasereturn" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata" ,
"type" : "purchasereturn" ,
"mediaType" : "application/json" ,
"size" : 4 ,
"limit" : 1000 ,
"offset" : 0
},
"rows" : [
{
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/purchasereturn/b875cc8f-313f-11e6-8a84-bae500000093" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata" ,
"type" : "purchasereturn" ,
"mediaType" : "application/json"
},
"id" : "b875cc8f-313f-11e6-8a84-bae500000093" ,
"accountId" : "f976ed28-2e58-11e6-8a84-bae500000001" ,
"owner" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/employee/metadata" ,
"type" : "employee" ,
"mediaType" : "application/json"
}
},
"shared" : false ,
"group" : {
"meta" : {
"href" : "https://api.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002" ,
"metadataHref" : "https://api.moysklad.ru/api/remap/1.2/entity/group/metadata" ,
"type" : "group" ,
"mediaType" : "application/json"
}
},
"updated" : "2016-06-13 11:20:55" ,
"name" : "00001" ,
"externalCode" : "E4l6sMtVixklOjgfK6VQt3" ,
"moment" : "2016-06-13 11:20:00" ,
"applicable" : true ,
"printed" : true ,
"published" : <