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

Схема взаимодействия с Инвойсбокс API v3

В зависимости от типа покупателя, схема взаимодействия системы «Инвойсбокс» и Магазина могут отличаться незначительно в части предоставления отчётных документов. Для покупателя - физического лица, отчётным документом по оплате является фискальный чек, зарегистрированный в онлайн кассе и ОФД. Для покупателя - юридического лица, отчётными документами может являтся акт, ТОРГ-12, отчёт о переводе средств, маршрутная квитанция и т.д. Набор необходимых документов и схема их предоставления покупателю оговаривается на стадии заключения договора между Магазином и системой «Инвойсбокс».

  1. Покупатели - физические лица
  2. Покупатели - организации и индивидуальные предприниматели

Покупатели - физические лица

Процесс создания заказа и оплаты счёта

sequenceDiagram autonumber participant Покупатель participant Магазин participant Инвойсбокс participant Онлайн касса rect rgb(204, 245, 204) Покупатель->>Магазин: Создает заказ Магазин->>Инвойсбокс: Вызов метода создания заказа Инвойсбокс->>Магазин: Идентификатор заказа и ссылка на оплату Магазин->>Покупатель: Перенаправление на платёжную страницу Покупатель-->>Инвойсбокс: Взаимодействие с платёжной страницей, получение счёта Покупатель->>Инвойсбокс: Оплата счёта Инвойсбокс->>Покупатель: Перенаправление покупателя на сайт магазина Инвойсбокс->>Онлайн касса: Чек "предоплата 100%" Инвойсбокс->>Покупатель: Предоставление чека "предоплата 100%" Инвойсбокс->>Магазин: Уведомление об успешной оплате end
  1. Покупатель оформляет заказ на сайте Магазина и выбирает способ оплаты через систему «Инвойсбокс».
  2. Магазин создает в системе «Инвойсбокс» заказ через метод API.
  3. Система возвращает ссылку на платёжную страницу для оплаты заказа.
  4. Магазин перенаправляет покупателя по полученной ссылке.
  5. Покупатель заполняет необходимые для оплаты сведения и получет счёт для оплаты.
  6. Покупатель оплачивает счёт.
  7. Система «Инвойсбокс» перенаправляет покупателя обратно на сайт Магазина.
  8. Система «Инвойсбокс» формирует и регистрирует чек “предоплата 100%” в онлайн кассе (при оплате физическим лицом).
  9. Система «Инвойсбокс» направляет чек “предоплата 100%” покупателю (физическому лицу).
  10. Система «Инвойсбокс» оповещает Магазин об успешной оплате заказа.

Процесс отгрузки и оформления чека “полный расчёт”

sequenceDiagram autonumber participant Покупатель participant Магазин participant Инвойсбокс participant Онлайн касса rect rgb(204, 245, 245) Магазин->>Инвойсбокс: Вызов метода отгрузки по заказу Инвойсбокс->>Онлайн касса: Чек "полный расчёт" Инвойсбокс->>Покупатель: Предоставление чека "полный расчёт" end
  1. В случае, если Магазин оказывает услугу или продаёт товар, Магазин направляет запрос отгрузки в систему «Инвойсбокс» по факту оказания услуги или факту отгрузки товара курьерской службой/службе доставки или покупателю. Если услуга оказывается онлайн, отгрузка по заказу может быть установлена автоматически.
  2. Система «Инвойсбокс» формирует и регистрирует чек “полный расчёт” в онлайн кассе (при оплате физическим лицом).
  3. Система «Инвойсбокс» направляет чек “полный расчёт” покупателю (физическому лицу).

Процесс оформления возврата

sequenceDiagram autonumber participant Покупатель participant Магазин participant Инвойсбокс participant Онлайн касса rect rgb(204, 204, 255) Покупатель->>Магазин: Обращается за возвратом по заказу Магазин-->Инвойсбокс: Получение списка позиций в заказе Магазин->>Инвойсбокс: Вызов метода оформления возврата Инвойсбокс->>Покупатель: Осуществление возврата денежных средств Инвойсбокс->>Онлайн касса: Чек "возврат" Инвойсбокс->>Покупатель: Предоставление чека "возврат" end
  1. Покупатель обращается в Магазин для оформления возврата заказа.
  2. Опционально, Магазин запрашивает через метод API доступные к возврату позиции в заказе.
  3. Магазин создает возврат в системе «Инвойсбокс» через метод API.
  4. Система «Инвойсбокс» осуществляет возврат денежных средств покупателю.
  5. Система «Инвойсбокс» формирует и регистрирует чек “возврат” в онлайн кассе (при оплате физическим лицом).
  6. Система «Инвойсбокс» направляет чек “возврат” покупателю (физическому лицу).

Покупатели - организации и индивидуальные предприниматели

Процесс создания заказа и оплаты счёта

sequenceDiagram autonumber participant Покупатель participant Магазин participant Инвойсбокс rect rgb(204, 245, 204) Покупатель->>Магазин: Создает заказ Магазин->>Инвойсбокс: Вызов метода создания заказа Инвойсбокс->>Магазин: Идентификатор заказа и ссылка на оплату Магазин->>Покупатель: Перенаправление на платёжную страницу Покупатель-->>Инвойсбокс: Взаимодействие с платёжной страницей, получение счёта Покупатель->>Инвойсбокс: Оплата счёта Инвойсбокс->>Покупатель: Перенаправление покупателя на сайт магазина Инвойсбокс->>Магазин: Уведомление об успешной оплате end
  1. Покупатель оформляет заказ на сайте Магазина и выбирает способ оплаты через систему «Инвойсбокс».
  2. Магазин создает в системе «Инвойсбокс» заказ через метод API.
  3. Система возвращает ссылку на платёжную страницу для оплаты заказа.
  4. Магазин перенаправляет покупателя по полученной ссылке.
  5. Покупатель заполняет необходимые для оплаты сведения и получет счёт для оплаты.
  6. Покупатель оплачивает счёт.
  7. Система «Инвойсбокс» перенаправляет покупателя обратно на сайт Магазина.
  8. Система «Инвойсбокс» оповещает Магазин об успешной оплате заказа.

Процесс отгрузки и оформления отчётных документов

sequenceDiagram autonumber participant Покупатель participant Магазин participant Инвойсбокс rect rgb(204, 245, 245) Магазин->>Инвойсбокс: Вызов метода отгрузки по заказу Инвойсбокс->>Покупатель: Предоставление отчётных документов Магазин-->>Покупатель: Предоставление отчётных документов (если требуется) end
  1. В случае, если Магазин оказывает услугу или продаёт товар, Магазин направляет запрос отгрузки в систему «Инвойсбокс» по факту оказания услуги или факту отгрузки товара курьерской службой/службе доставки или покупателю. Если услуга оказывается онлайн, отгрузка по заказу может быть установлена автоматически.
  2. Система «Инвойсбокс» формирует отчёт о переводе средств, а также дополнительный набор отчётных документов по доверенности от магазина, если требуется. При оказании услуг формируется акт, при продаже товаров - формируется ТОРГ-12. Система «Инвойсбокс» направляет пакет отчётных документов покупателю по электронной почте, оригиналы по почте и с помощью ЭДО.
  3. Магазин направляет покупателю пакет отчётных документов, если это предусмотрено процессом.

Процесс оформления возврата

sequenceDiagram autonumber participant Покупатель participant Магазин participant Инвойсбокс rect rgb(204, 204, 255) Покупатель->>Магазин: Обращается за возвратом по заказу Магазин-->Инвойсбокс: Получение списка позиций в заказе Магазин->>Инвойсбокс: Вызов метода оформления возврата Инвойсбокс->>Покупатель: Осуществление возврата денежных средств Инвойсбокс->>Покупатель: Предоставление отчётных документов Магазин-->>Покупатель: Предоставление отчётных документов (если требуется) end
  1. Покупатель обращается в Магазин для оформления возврата заказа.
  2. Опционально, Магазин запрашивает через метод API доступные к возврату позиции в заказе.
  3. Магазин создает возврат в системе «Инвойсбокс» через метод API.
  4. Система «Инвойсбокс» осуществляет возврат денежных средств покупателю.
  5. Система «Инвойсбокс» формирует набор отчётных документов по доверенности от магазина, если требуется. При оказании услуг формируется акт, при продаже товаров - формируется ТОРГ-12. Система «Инвойсбокс» направляет пакет отчётных документов покупателю по электронной почте, оригиналы по почте и с помощью ЭДО.
  6. Магазин направляет покупателю пакет отчётных документов, если это предусмотрено процессом.

Читать далее »