Обновяване на информация за документ чрез API

Предназначение:Използва се за обновяване на информацията в документ
Функция:document_update
Параметри:
  1. type - вид документ // 1 - фактура, 2 - проформа, 3 - стокова разписка, 4 - протокол)
  2. id - ID на документ
  3. document - oбект (StdClass в PHP), който съдържа полета:
    • sum - Данъчна основа в лева
    • dds_percent - ДДС % - 0, 9, 20 или др.
    • null_value - Основание за нулева ставка или ненач. на ДДС
    • payment_method_id - Начин на плащане // 1 - в брой, 2 - по банка, Други начини на плащане
    • note - Забележка към документ
    • paid - Статус на плащане // 1 - платен, 0 - неплатен, 2 - частично платен
    • kind - Кредитно или дебитно известие // използва се само при вид на документ - 1, 1 - за КИ, 2 - за ДИ.
    • reason - Основание за кредитно или дебитно известие
    • courier_id - №/ID на куриер
    • waybill - № на товарителница
    • client_id- ID на клиент
    • client_name - Име на клиент
    • client_place - Населено място на клиент
    • client_address - Данъчен адрес на клиент
    • client_number - ЕИК/ЕГН на клиент
    • client_dds - ИН по ДДС на клиент
    • client_face - МОЛ на клиент
    • client_phone - Телефон на клиент
    • client_email - Email на клиент
    • receiver - Име на получател
    • company_face - МОЛ на доставчик
    • creator - Съставител на документа
    • place - Място на сделката // ако не е посочено се използва мястото от данъчния адрес на доставчика
    • rows - Редове на документ - масив от обекти StdClass със следните полета:
          » name - Име на стока или услуга
          » quantity - Количество на стока/услуга
          » measure_id - Мярка на стока/услуга - 70 за брой. Списък с мерни единици
          » price - Ед. цена на стока/услуга в лева
          » code - Артикулен номер - използва се задължително ако се ползва модул "Склад" или някоя от следващите две настройки
          » load_name_from_db - Зареждане на името от базата данни - можете да не подавате името през API, а да се извлича директно от базата данни спрямо подадения артикулен номер. Въведете 1 ако желаете това действие.
          » load_price_from_db - Зареждане на цената от базата данни - можете да не подавате ед. цена през API, а да се извлича директно от базата данни спрямо подадения артикулен номер. Въведете 1 ако желаете това действие.

    • Допълнителни полета за Invoice - документ на английски език
    • invoice_currency_id - Валута за английски език. Списък в валути.
    • currency_fixing - Фиксинг спрямо лева - по подразбиране е 1.
    • retail_sum - Обща сума в съответната валутата - ако се пропусне се изчислява автоматично спрямо фиксинга.
Резултат:Обект $document от тип StdClass. В $document->id се съдържа ID на документа, а в $document->number неговия номер.
Грешки (код): - Не е въведен ЕИК. Можете да използвате 000000000, 111111111 или 999999999 ако не знаете ЕИК на клиента! (501)
- Не е подаден последния параметър с детайлите на документа и редовете! (502)
- Невалиден вид на документ. Използвайте 1 за фактура/и, 2 за проформа/и, 3 за стокови разписка/и или 4 за протокол/и. (3)
Забележки:1. Ако някое поле свързано с клиента не е зададено в третия параметър на функцията, тогава то се извлича от базата данни в зависимост от въведения ЕИК номер.
2. Останалата инфорамация за документа (напр. Съставител) се извлича от последно издадения документ.
3. Тази функция не променя складовите наличности.
4. Ако създавате документ само в чуждестранна валута, тогава можете да въведете единичните цени в редовете в съответната валута и за фиксинг да зададете 1.
Примерен код: // Примерният код се вмъква между НАЧАЛО и КРАЙ в инициализиращия код описан тук.

$id = 20; // ID на документ
$type = 3; // ст. разписка

$document = new StdClass();

$document->sum = 48;
$document->dds_percent = 20;
$document->invoice_currency_id = 4; // GBP
$document->currency_fixing = 2.234;
$document->client_number = '999999999'; // ЕИК на клиента, 999999999 - ако е частно лице
$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->kind = 0; // използва се само в комбинация с $doc_type = 1; // фактура, само когато се издават известия, 1 - за кредитно, 2 - за дебитно.
$document->courier_id = 1; // незадължително поле
$document->waybill = 'номер на товарителница';

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

$new_document = $FAPI->document_update($doc_type, $doc_id, $document);
if(isset($new_document)){
  echo 'Документът е обновен успешно';
}else{
  echo ' Възникна грешка при обновяване!';
}
Създайте си фирмен профил и изпробвайте Фактуриране