Обновяване на информация за документ чрез API
Предназначение: | Използва се за обновяване на информацията в документ |
Функция: | document_update |
Параметри: |
type - вид документ // 1 - фактура, 2 - проформа, 3 - стокова разписка, 4 - протокол)
id - ID на документ
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 ' Възникна грешка при обновяване!';
}
|