Създаване на документ чрез API

Функция/команда:document_create
Предназначение:Използва се за създаване на нов документ
Параметри:
  1. client_number- ЕИК на клиент (използвайте 000000000, 111111111 или 999999999 за физически лица)
  2. type - Вид документ (1 - фактура, 2 - проформа, 3 - стокова разписка, 4 - протокол, 5 - доставка)
  3. document - обект (StdClass в PHP), който съдържа полета за:
    • sum - Данъчна основа
    • dds_percent - ДДС % - 0, 9, 20 или др.
    • null_value - Основание за нулева ставка или ненач. на ДДС.
    • payment_method_id - Код на начин на плащане - 1 - в брой, Таблица с други кодове
    • eshop_id - №/ID на онлайн магазин (незадължително)
    • order_id - № на поръчка/заявка (незадължително)
    • order_date - Дата на поръчка/заявка (незадължително)
    • pos_number - № на VPOS терминала (незадължително)
    • transaction_number - авторизационен номер на транзакция (Retrieval reference number RRN) (незадължително)
    • payment_provider_number - номер на доставчика на платежни услуги. Посочва се ЕИК за български и ДДС №, а за чуждестранни лица (незадължително)
    • note - Забележка към документ
    • paid - Статус на плащане - 1 - платен, 0 - неплатен, 2 - частично платен
    • kind - Кредитно или дебитно известие - използва се само при вид на документа type - 1. 1 - за КИ, 2 - за ДИ.
    • reason - Основание за кредитно или дебитно известие
    • client_id - ID на клиент
    • client_name - Име на клиент
    • client_country_id - Код на държава на клиент
    • client_place - Населено място на клиент
    • client_address - Данъчен адрес на клиент (без нас. място)
    • client_dds - ИН по ДДС на клиент
    • client_face - МОЛ на клиент
    • client_phone - Телефон на клиент
    • client_email - Email на клиент
    • receiver - Име на получател
    • company_face - МОЛ на доставчик
    • creator - Съставител на документа
    • place - Място на сделката - ако не е посочено се използва мястото от данъчния адрес на доставчика
    • numbers_id - ID на търговски обект/номерация - ако не е посочено се използва основния обект/номерация (0). ID на ТО може да видите в настройките на софтуера.
    • add_client_to_db - Добавяне на клиента в базата с данни. Въведете 1 и ако клиентът не съществува в номенклатурата с клиенти той ще се добави автоматично. Прави се проверка по ЕИК/ЕГН.
    • update_quantities - Актуализиране на складовите наличности при ползване на модул "Склад". Въведете 1 ако желаете да се регистрират движения в склада.
    • rows - Редове на документ. Масив от обекти със следните полета:
      •   » name - Име на стока или услуга
      •   » quantity - Количество на стока/услуга
      •   » measure_id - Мярка на стока/услуга - 70 за брой. За повече информация - ДРУГИ > Мерни единици
      •   » price - Ед. цена на стока/услуга в лева
      •   » code - Артикулен номер - използва се задължително ако се ползва модул "Склад" или някоя от следващите две настройки
      •   » load_name_from_db - Зареждане на името от базата данни - можете да не подавате името през API, а да се извлича директно от базата данни спрямо подадения артикулен номер. Въведете 1 ако желаете това действие.
      •   » load_price_from_db - Зареждане на цената от базата данни - можете да не подавате ед. цена през API, а да се извлича директно от базата данни спрямо подадения артикулен номер. Въведете 1 ако желаете това действие.
      • Допълнителни полета за Invoice - документ на английски език:
    • invoice_currency_id - Код на валута в Invoice - тук са описани всички възможни кодове.
    • currency_fixing - Фиксинг спрямо лева - по подразбиране е 1.
    • retail_sum - Обща сума в съответната валутата. Ако се пропусне се изчислява автоматично спрямо фиксинга.
Postman пример: https://fakturirane.com/api/v1/document_create?client_number=147022197&type=2&document={"sum":"100","payment_method_id":"2","rows":[{"name":"Стока 1", "quantity":"4", "measure_id":"70","price":"10"}]}
Резултат: {
    "error": 0,
    "document": {
       "id": "1",
       "number": "1"
   }
}
-error - Код на грешка
-document - обект със следните полета:
  -id - ID на документа
  -number - номера на документа
Възможни грешки: - Не е въведен ЕИК. Можете да използвате 000000000, 111111111 или 999999999 ако не знаете ЕИК на клиента! (501)
- Не е подаден последния параметър с детайлите на документа и редовете! (502)
- Невалиден вид на документ. Използвайте 1 за фактура/и, 2 за проформа/и, 3 за стокови разписка/и или 4 за протокол/и. (3)
Забележки:1. Ако някое поле свързано с клиента не е зададено в третия параметър на функцията, тогава то се извлича от базата данни в зависимост от въведения ЕИК.
2. Останалата инфорамация за документа (напр. Съставител) се извлича от последно издадения документ.
3. Тази функция не променя складовите наличности ако не се подаде параметър update_quantities = 1.
4. Ако създавате документ само в чуждестранна валута, тогава можете да въведете единичните цени в редовете в съответната валута и за фиксинг да зададете 1.
5. В СУПТО може да се създава само проформа-фактура
Примерен PHP код: // Следния код се вмъква в примерния скрипт.

$client_number = '000000000'; // ЕИК на клиента, 000000000 - ако е частно лице
$doc_type = 2; // 1 - за фактура, 2 - проформа, 3 - протокол, 4 - ст. разписка

$document = new StdClass();

$document->client_name = 'Име на клиент'; // ако не се зададе се извлича от базата данни спрямо въведения ЕИК
$document->client_place = 'Град';
$document->client_address = 'Данъчен адрес на клиента';
$document->client_dds = 'BG999999999';
$document->client_face = 'Иван Иванов';
$document->client_phone = 'Телефон';
$document->client_email = 'email@na.klient';
$document->receiver = 'Иван Иванов';
$document->reason = 'Основание за кредитно или дебитно известие'; // попълва се ако се издава кредитно или дебитно известие
$document->company_face = 'Георги Георгиев'; // ако не е попълнено се използва посочения МОЛ в настройките
$document->creator = 'Георги Георгиев'; // ако не е попълнено се използва посочения съставител в настройките
$document->place = 'гр. София'; // Място на сделката, ако не е посочено се използва мястото от данъчния адрес на доставчика
$document->numbers_id = 0; // Коментирайте ако работите с основната номерация на програмата.
$document->kind = 0; // използва се само в комбинация с $doc_type = 1; // фактура, само когато се издават известия, 1 - за кредитно, 2 - за дебитно.
$document->add_client_to_db = 1; // използва се ако клиентът не съществува в номенклатурата с клиенти и желаете да го добавите. Прави се проверка по ЕИК/ЕГН.

$document->rows = array();

// Ред 1
$row = new StdClass();
$row->name = 'Стока 1';
$row->quantity = 4;
$row->measure_id = 70;
$row->price = 10.00;
$document->rows[] = $row;

// Ред 2
$row = new StdClass();
$row->name = 'Стока 2';
$row->quantity = 1;
$row->measure_id = 90;
$row->price = 15.00;
$document->rows[] = $row;

$document->payment_method_id = 1;
$document->sum = 55.00;
$document->dds_percent = 20;
$document->null_value = 'Неначислен ДДС съгласно чл.113 ал.9 от ЗДДС'; // основание за нулева ставка или ненач. на ДДС. Попълва се само ако ДДС е 0%.
$document->note = 'Забележка към документ';
$document->paid = 1; // маркиране като платен, 0 - неплатен

$new_document = $FAPI->document_create($client_number, $doc_type, $document);
if(isset($new_document)){
  echo 'Документът е създаден успешно';
}else{
  echo ' Документът не е създаден!';
}
Назад
Създайте си фирмен профил и изпробвайте Фактуриране
Да, съгласявам се!Чрез използването на този уеб сайт вие се съгласявате с използването на cookies (т.нар. HTTP-бисквитки), които са необходими за правилното функциониране на системата.