Документы

Общие сведения

Шаблоны документов

Шаблон - предзаполненный стандартными полями JSON-объект, который затем можно использовать для успешного создания документа. Средствами JSON API можно получать предзаполненные шаблоны документов. Они могут быть предзаполнены как на основе других документов, так и стандартными значениями без связей с другими документами. Для этого, во всех документах, по которым можно получить шаблон, существует специальный ресурс Шаблон документа, адрес которого формируется следующим образом:
https://api.moysklad.ru/api/remap/1.2/entity/<ключевое слово для документа>/new
В тело PUT запроса по данному ресурсу нужно передать метаданные документа, на основе которого будет создан шаблон нового документа, либо просто передать пустое тело запроса. Метаданные должны быть "обернуты" в объект, имя которого есть ключевое слово для документа-основания в JSON API. Для каждого из данных ресурсов есть примеры запросов и ответов.
На данный момент можно получить шаблоны следующих документы на основании других:

Документ	Основание, на котором он может быть создан
Cчет покупателю (invoiceout)	Заказ покупателя (customerorder)
Возврат покупателя (salesreturn)	Отгрузка (demand), Розничная продажа (retaildemand)
Возврат поставщику (purchasereturn)	Приемка (supply)
Входящий платеж (paymentin)	Заказ покупателя (customerorder), Возврат поставщику (purchasereturn), Отгрузка (demand), Счет покупателю (invoiceout), Полученный отчет комиссионера (commissionreportin)
Заказ на производство (processingorder)	Техкарта (processingplan)
Заказ поставщику (purchaseorder)	Внутренний заказ (internalorder)
Исходящий платеж (paymentout)	Возврат покупателя (salesreturn), Приемка (supply), Счет поставщика (invoicein), Заказ поставщику (purchaseorder), Выданный отчет комиссионера (commissionreportout)
Оприходование (enter)	Инвентаризация(inventory)
Отгрузка (demand)	Заказ покупателя (customerorder)
Перемещение (move)	Внутренний заказ (internalorder)
Приходный ордер (cashin)	Заказ покупателя (customerorder), Возврат поставщику (purchasereturn), Отгрузка (demand), Счет покупателю (invoiceout), Полученный отчет комиссионера (commissionreportin)
Расходный ордер (cashout)	Возврат покупателя (salesreturn), Приемка (supply), Счет поставщика (invoicein), Заказ поставщику (purchaseorder), Выданный отчет комиссионера (commissionreportout)
Розничная продажа (retaildemand)	Розничная смена, Заказ покупателя
Списание (loss)	Возврат покупателя (salesreturn), инвентаризация(inventory)
Счет поставщика (invoicein)	Заказ поставщику (purchaseorder)
Техоперация (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": 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/faf44002-2e58-11e6-8a84-bae500000053",
          "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/purchasereturn/b875cc8f-313f-11e6-8a84-bae500000093/positions",
          "type": "purchasereturnposition",
          "mediaType": "application/json",
          "size": 1,
          "limit": 1000,
          "offset": 0
        }
      },
      "supply": {
        "meta": {
          "href": "https://api.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089",
          "metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/supply/metadata",
          "type": "supply",
          "mediaType": "application/json"
        }
      },
      "payedSum": 0
    },
    {
      "meta": {
        "href": "https://api.moysklad.ru/api/remap/1.2/entity/purchasereturn/d43161ea-3140-11e6-8a84-bae5000000c6",
        "metadataHref": "https://api.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
        "type": "purchasereturn",
        "mediaType": "application/json"
      },
      "id": "d43161ea-3140-11e6-8a84-bae5000000c6",
      "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:28:34",
      "name": "00002",
      "externalCode": "-5xto6PjiGhuL8RAky-9c3",
      "moment": "2016-06-13 11:22: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": 273000,
      "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/faf44002-2e58-11e6-8a84-bae500000053",
          "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"
        </