Link Поиск Меню Развернуть Документ

Создание заказа с использованием реквизитов продавца

Для интеграции с банками и крупными платежными агрегаторамии (далее Агент) используется специальный режим сценария создания заказа, который не требуется идентификационные данные магазина Инвойсбокс, вместо них используется реквизиты юр. лица. Основное отличие заключается в:

  • ИНН и КПП вместо идентифкатора магазина
  • Авторизационные данные агента вместо авторизационных данных магазина

Для создания заказа, необходимо вызвать следующий метод API:

Пример запроса
POST /v3/billing/api/order/order
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e
Content-Type: application/json
User-Agent: MyApp 1.0
Accept: application/json
{
  "seller": {
    "type": "counterparty",
    "vatNumber": "232323232323",
    "taxRegistrationReasonCode": "232323232323"
   },
  "merchantOrderId": "m-1608560079",
  "amount": 371.88,
  "successUrl": "https://merchant.ru/order/xxx?result=success",
  "failUrl": "https://merchant.ru/order/xxx?result=fail",
  "returnUrl": "https://merchant.ru/order/xxx?result=return",
  "vatAmount": 61.98,
  "basketItems": [
    {
      "sku": "5fe0adcfa7fb4",
      "name": "Бронирование номера",
      "measure": "шт.",
      "measureCode": "796",
      "grossWeight": 0,
      "netWeight": 0,
      "quantity": 3,
      "amount": 123.96,
      "amountWoVat": 103.3,
      "totalAmount": 371.88,
      "totalVatAmount": 61.98,
      "vatCode": "RUS_VAT20",
      "type": "service",
      "paymentType": "full_prepayment"
    }
  ],
  "metaData": {
    "@type": "LodgingReservation",
    "reservationId": "abc456",
    "reservationStatus": "https://schema.org/ReservationConfirmed",
    "underName": {
      "@type": "Person",
      "name": "John Smith"
    },
    "reservationFor": {
      "@type": "LodgingBusiness",
      "name": "Hilton San Francisco Union Square",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "333 O'Farrell St",
        "addressLocality": "San Francisco",
        "addressRegion": "CA",
        "postalCode": "94102",
        "addressCountry": "US"
      },
      "telephone": "415-771-1400"
    },
    "checkinTime": "2017-04-11T16:00:00-08:00",
    "checkoutTime": "2017-04-13T11:00:00-08:00"
  },
  "expirationDate": "2020-12-22T00:00:00+00:00",
  "languageId": "ru",
  "currencyId": "RUB",
  "description": "Оплата номера в отеле",
  "customer": {
    "type": "private",
    "name": "Peter",
    "phone": "79001112233",
    "email": "peter@domain.com",
    "vatNumber": "",
    "registrationAddress": ""
  }
}

CreateAgentOrderRequest

Объект включает в себя все поля CreateOrderRequest а так же:

СвойствоОбязательноеТипОписаниеПример значения
sellerдаSellerДанные продавца{"type": "counterparty", "vatNumber":"232323232323", "taxRegistrationReasonCode": "232323232323"}

Seller

Повторяет свойства объекта CreateOrderRequest с дополнительными свойствами:

СвойствоОбязательноеТипОписаниеПример значения
typeдаstring(36)Тип продавца, доступные значения: counterpartycounterparty
countryIdдаstring(3)Страна, доступные значения: RUSRUS
vatNumberдаstring(20)ИНН7710044140
taxRegistrationReasonCodeнет для ИПstring(9)КПП770201001

Если продавец не найден в системе Инвойсбокс, то будет возвращена ошибка.