Создание акта через упрощенный API (Simple)

POST /api/{lang}/documents/act/simple

Упрощенный метод создания акта с минимальным набором обязательных полей. Система автоматически заполняет недостающие данные на основе переданной информации.

Особенности Simple API:

Требует только базовые поля: номер, дата, контрагент, позиции товаров/услуг
Автоматически получает данные компаний из справочника по ИНН/ПИНФЛ
Автоматически рассчитывает общую сумму документа
Создает акт сразу в готовом для отправки виде

Обязательные поля:

ActNo - номер акта
ActDate - дата акта
BuyerTin - ИНН/ПИНФЛ покупателя
ContractNo - номер договора
ContractDate - дата договора
ActText - текст акта
Products[] - массив товаров/услуг

Формат товаров:

json

{
  "ProductName": "Название услуги",
  "Count": 1,
  "Summa": 1000000,
  "TotalSum": 1000000,
  "MeasureId": "796",
  "PackageCode": "PCE",
  "PackageName": "Штука"
}

POST Request

bash

curl -X POST "https://back.e-invoice.uz/api/{lang}/documents/act/simple" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "ActNo": "string",
      "ActDate": "string",
      "ActText": "string",
      "BuyerTin": "string",
      "SellerTin": "string",
      "ContractNo": "string",
      "ContractDate": "string",
      "SellerBranchCode": "string",
      "SellerBranchName": "string",
      "BuyerBranchCode": "string",
      "BuyerBranchName": "string",
      "Notes": "string",
      "Products": [
        {
          "ProductName": "string",
          "Count": 0,
          "Summa": 0,
          "TotalSum": 0,
          "MeasureId": "string",
          "PackageCode": "string",
          "PackageName": "string",
          "CatalogCode": "string",
          "CatalogName": "string"
        }
      ]
    }
  }'

php

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_TOKEN')
    ->acceptJson()
    ->post('https://back.e-invoice.uz/api/{lang}/documents/act/simple', [
    'params' => [
      'ActNo' => 'string',
      'ActDate' => 'string',
      'ActText' => 'string',
      'BuyerTin' => 'string',
      'SellerTin' => 'string',
      'ContractNo' => 'string',
      'ContractDate' => 'string',
      'SellerBranchCode' => 'string',
      'SellerBranchName' => 'string',
      'BuyerBranchCode' => 'string',
      'BuyerBranchName' => 'string',
      'Notes' => 'string',
      'Products' => [
        [
          'ProductName' => 'string',
          'Count' => 0,
          'Summa' => 0,
          'TotalSum' => 0,
          'MeasureId' => 'string',
          'PackageCode' => 'string',
          'PackageName' => 'string',
          'CatalogCode' => 'string',
          'CatalogName' => 'string'
        ]
      ]
    ]
  ]);

javascript

const response = await fetch("https://back.e-invoice.uz/api/{lang}/documents/act/simple", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "params": {
      "ActNo": "string",
      "ActDate": "string",
      "ActText": "string",
      "BuyerTin": "string",
      "SellerTin": "string",
      "ContractNo": "string",
      "ContractDate": "string",
      "SellerBranchCode": "string",
      "SellerBranchName": "string",
      "BuyerBranchCode": "string",
      "BuyerBranchName": "string",
      "Notes": "string",
      "Products": [
        {
          "ProductName": "string",
          "Count": 0,
          "Summa": 0,
          "TotalSum": 0,
          "MeasureId": "string",
          "PackageCode": "string",
          "PackageName": "string",
          "CatalogCode": "string",
          "CatalogName": "string"
        }
      ]
    }
  }),
});

python

import requests

response = requests.post(
    "https://back.e-invoice.uz/api/{lang}/documents/act/simple",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
    "params": {
      "ActNo": "string",
      "ActDate": "string",
      "ActText": "string",
      "BuyerTin": "string",
      "SellerTin": "string",
      "ContractNo": "string",
      "ContractDate": "string",
      "SellerBranchCode": "string",
      "SellerBranchName": "string",
      "BuyerBranchCode": "string",
      "BuyerBranchName": "string",
      "Notes": "string",
      "Products": [
        {
          "ProductName": "string",
          "Count": 0,
          "Summa": 0,
          "TotalSum": 0,
          "MeasureId": "string",
          "PackageCode": "string",
          "PackageName": "string",
          "CatalogCode": "string",
          "CatalogName": "string"
        }
      ]
    }
  },
)

ruby

require "net/http"
require "json"
require "uri"

uri = URI("https://back.e-invoice.uz/api/{lang}/documents/act/simple")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = {
  "params" => {
    "ActNo" => "string",
    "ActDate" => "string",
    "ActText" => "string",
    "BuyerTin" => "string",
    "SellerTin" => "string",
    "ContractNo" => "string",
    "ContractDate" => "string",
    "SellerBranchCode" => "string",
    "SellerBranchName" => "string",
    "BuyerBranchCode" => "string",
    "BuyerBranchName" => "string",
    "Notes" => "string",
    "Products" => [
      {
        "ProductName" => "string",
        "Count" => 0,
        "Summa" => 0,
        "TotalSum" => 0,
        "MeasureId" => "string",
        "PackageCode" => "string",
        "PackageName" => "string",
        "CatalogCode" => "string",
        "CatalogName" => "string"
      }
    ]
  }
}.to_json

response = http.request(request)

200 Response

json

{
  "success": {
    "act_id": "string"
  }
}

Request Body

application/json

object

params object Required
Параметры создания акта
- ActNo string Required
  
  Номер акта
- ActDate string Required
  
  Дата акта (Y-m-d)
- ActText string Required
  
  Текст акта
- BuyerTin string Required
  
  ИНН/ПИНФЛ покупателя
- SellerTin string
  
  optional ИНН/ПИНФЛ продавца (по умолчанию текущий пользователь)
- ContractNo string Required
  
  Номер договора
- ContractDate string Required
  
  Дата договора (Y-m-d)
- SellerBranchCode string
  
  optional Код филиала продавца
- SellerBranchName string
  
  optional Название филиала продавца
- BuyerBranchCode string
  
  optional Код филиала покупателя
- BuyerBranchName string
  
  optional Название филиала покупателя
- Notes string
  
  optional Примечания
- Products array Required
  
  Массив товаров/услуг
  
  Items
  
  object
  
  ProductName string Required
  
  Название товара/услуги
  
  Count number Required
  
  Количество
  
  Summa number Required
  
  Цена за единицу
  
  TotalSum number Required
  
  Общая сумма
  
  MeasureId string
  
  optional ID единицы измерения
  
  PackageCode string
  
  optional Код упаковки
  
  PackageName string
  
  optional Название упаковки
  
  CatalogCode string
  
  optional Код товара по каталогу
  
  CatalogName string
  
  optional Название товара по каталогу

Responses

200

Успешное создание

application/json

object

success object
- act_id string

400

application/json

mixed

One of

object

Ошибка валидации

error object
- message string

object

Ошибка сохранения

error object
- message string