API: товарно-транспортная накладная

POST /api/v1/documents/ttn

Формирует печать товарно-транспортной накладной (форма № 1-Т) без сохранения в кабинете и возвращает PDF или XLSX.

Список шаблонов: GET /api/v1/documents/ttn/templates

Пример

{
  "format": "pdf",
  "template": 420,
  "response": "json",
  "number": "15",
  "date": "2026-08-23",
  "series_doc": "АА",
  "transport_delivery_time": "2026-08-24",
  "transport_vouncher": "77",
  "transport_car": "КАМАЗ 65117",
  "transport_car_number": "А123ВС77",
  "transport_driver": "Кузнецов К.К.",
  "transport_driver_certificate": "77 12 345678",
  "transport_license": "стандартная",
  "transport_transportation": "автомобильная",
  "transport_loading": "г. Москва, ул. Складская, д. 1",
  "transport_unloading": "г. Казань, ул. Строительная, д. 5",
  "print_stamp": true,
  "seller": {
    "name": "ООО Ромашка",
    "inn": "7701234567",
    "kpp": "770101001",
    "okpo": "12345678",
    "address": "г. Москва",
    "phone": "495-000-00-00",
    "director": "Иванов Иван Иванович",
    "director_post": "Генеральный директор",
    "accountant": "Сидорова Анна",
    "stamp_url": "https://example.com/stamp.png",
    "director_sign": "https://example.com/director.png"
  },
  "buyer": {
    "name": "ООО Плательщик",
    "inn": "7707654321",
    "okpo": "87654321",
    "address": "г. Казань"
  },
  "consignee": {
    "name": "ООО Грузополучатель",
    "okpo": "11223344",
    "address": "г. Казань, ул. Строительная, д. 5"
  },
  "carrier": {
    "name": "ООО Перевозчик",
    "okpo": "55667788",
    "address": "г. Москва"
  },
  "items": [
    {
      "name": "Кирпич керамический",
      "product_code": "К-01",
      "unit": "шт",
      "quantity": 1000,
      "price": 15,
      "vat": 20,
      "packaging": "поддон",
      "places": 10,
      "weight_gross": 3.5,
      "warehouse_card": "8"
    }
  ],
  "cargo_info": [
    {
      "name": "Кирпич",
      "docs": "накладная № 15",
      "packaging": "поддон",
      "quantity": "10",
      "way": "по стандарту",
      "code": "6914",
      "weight": "3.5"
    }
  ]
}

items можно передать объектом с числовыми ключами. Пустой массив ([]) не считается ошибкой: в таблицу попадёт одна пустая строка.

Основные поля

Поле	Описание
`format`	`pdf` (по умолчанию) или `xlsx`
`template`	код печатной формы, по умолчанию `420`
`number`, `date`	номер и дата
`series_doc`	серия
`seller`	грузоотправитель
`buyer`	плательщик
`consignee`	грузополучатель
`carrier`	перевозчик
`customer`	заказчик (автомобильной перевозки)
`items`	товарный раздел; пустой массив печатает одну пустую строку
`cargo_info`	сведения о грузе (до 3 строк в печати)
`currency`	код валюты, по умолчанию `643`
`nds`	ставка НДС по документу, если не задана у позиций
`vat_correct`	ручная сумма НДС в итоговой строке, например `1135.65`. Если не передана, НДС считается по позициям
`print_stamp`	печать и подписи
`decimal_places`	знаков после запятой в печати: `0`–`3`; (алиасы `decimals`, `znaki`; см. Обзор)
`number_format`	отображение сумм: `apostrophe` (`1'500.00`) или `space` (`1 500,00`); (см. Обзор)
`response`	`file` или `json`

Поля сторон одинаковые: name, inn, kpp, okpo, address, phone, fax, director, director_post, bank.

Транспорт

Поле	Описание
`transport_delivery_time`	срок доставки груза `Y-m-d`
`transport_vouncher`	к путевому листу №
`transport_car`	марка автомобиля
`transport_car_number`	номерной знак автомобиля
`transport_driver`	водитель (Ф.И.О.)
`transport_driver_certificate`	удостоверение водителя
`transport_trailer1`, `transport_trailer_number1`	марка и гос. номер 1-го прицепа
`transport_trailer2`, `transport_trailer_number2`	марка и гос. номер 2-го прицепа
`transport_license`	лицензионная карточка: `стандартная` или `ограниченная`
`transport_transportation`	вид перевозки
`transport_loading`	пункт погрузки
`transport_unloading`	пункт разгрузки
`extra_charge`	наценка, %
`transportation_costs`	складские или транспортные расходы

Сведения о грузе

Поле	Описание
`name`	краткое наименование груза
`docs`	с грузом следуют документы
`packaging`	вид упаковки
`quantity`	количество мест
`way`	способ определения массы
`code`	код груза
`container`	номер контейнера
`class`	класс груза
`weight`	масса брутто, т

Шаблоны

`template`	Название
`420`	ТТН(1-Т)

Актуальный список всегда в GET /api/v1/documents/ttn/templates.

Позиция

Поле	Описание
`name`	наименование продукции, товара (груза)
`quantity`	обязательно, кроме пустой строки
`price`	обязательно, кроме пустой строки
`vat`	ставка НДС
`unit`	ед. изм.
`unit_code`	код единицы измерения
`product_code`	код продукции (номенклатурный номер)
`list_number`	номер прейскуранта и дополнения к нему
`article`	артикул или номер по прейскуранту
`packaging`	вид упаковки
`places`	количество мест
`weight_gross`	масса, т
`warehouse_card`	порядковый номер записи по складской картотеке
`vat_value`	игнорируется, считается на сервере
`sum`	игнорируется, считается на сервере

Строки is_header и is_subtotal принимаются, но в печатную форму ТТН не выводятся.

Для примера выше сумма будет 15000.00, НДС 2500.00.

Пример​

Основные поля​

Транспорт​

Сведения о грузе​

Шаблоны​

Позиция​