PHPackages mare06xa/beez - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. mare06xa/beez ActiveLibrary[Payment Processing](/categories/payments) mare06xa/beez ============= Package for creating invoices with Cebelca BIZ in Laravel. 461PHP Since Feb 17Pushed 7y ago2 watchersCompare [ Source](https://github.com/markoKodric/beez-cebelca-api)[ Packagist](https://packagist.org/packages/mare06xa/beez)[ RSS](/packages/mare06xa-beez/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependenciesVersions (2)Used By (0) Beez ==== [](#beez) Beez allows you to create invoices and generate invoices PDF files. Installation ------------ [](#installation) Require this package with [composer](http://getcomposer.org). ``` composer require mare06xa/beez ``` Laravel 5.5+ uses **Package Auto-Discovery**, so doesn't require you to manually add the ServiceProvider. **Laravel 5.4 and below:**If you don't use auto-discovery, add the ServiceProvider to the providers array in `config/app.php` ``` Mare06xa\Beez\BeezServiceProvider::class ``` Configuration ------------- [](#configuration) You will need API token from Cebelca BIZ. - Go to ****, sign up and confirm your account - Sign in and go to Settings (Nastavitve) in top right corner - Click "Access settings" (Nastavitve dostopa) in top left corner - On the bottom you will find "API Access" (API dostop) section - Click the button to activate your API access and get the API token Add this lines to your `.env` configuration file ``` BIZ_TOKEN={Insert your token here} BIZ_DOMAIN=https://www.cebelca.biz BIZ_TEST_MODE=false ``` --- Usage ----- [](#usage) ***Registering location*** Before you can fiscalize invoices you need to register location with Tax Office. If you want to TEST fiscalize invoices you need to register location to TEST FURS server. You can do this in Cebelca web interface too. This is the way to do it with API. This way you get and ID of location automatically. **You don't need to use this if you already have the location.** KeyDescriptionFormatRequiredtypeLocation type - A: Movable object (car, taxi, ...) - B: Fixed address - C: Electronic deviceStringYeslocation\_idInternal id of location (you determine it, must be unique)StringYesregister\_idInternal id of register (you determine it, must be unique)StringYes--- ***Insert the customer (partner)*** - If the partner is already in the database it returns it's ID - If it's not it adds it and returns it's ID KeyDescriptionFormatRequirednameCompany or person's nameStringYesstreetCompany or person's street addressStringNopostalCompany or person's postal codeString/IntegerNocityCompany or person's cityStringNocountryCompany or person's countryStringNovatidCompany or person's VAT numberStringNo--- ***Add the Invoice head*** **Option 1**: Invoice consists of invoice head and multiple invoice body lines. First you add the Invoice head and get the ID of added invoice. KeyDescriptionFormat / OptionsRequireddate\_sentDate when invoice was issuedDate (d.m.Y)Yesdate\_servedDate when service or item was deliveredDate (d.m.Y)Yesdate\_to\_payDate to which invoice should be payedDate (d.m.Y)Yesdate\_payedDate when invoice was paidDate (d.m.Y)NopaymentMark that invoice has been paidString \["paid"\]No**Option 2**: Use ***withMoreOptions*** parameter in function. *Additional options*: KeyDescriptionFormatRequiredtaxnumCompany or person's VAT numberStringNoid\_document\_extOverrides the ID of invoice sent by Cebelca **(must be unique)**String/IntegerNoid\_currencyForeign currency ID (default currency is EUR)String/IntegerNoconv\_rateConversion rate between foreign curreny and EURString/FloatNo--- ***Add the invoice body*** Adds one/multiple items to the invoice. KeyDescriptionFormatRequiredtitleName or description of the service/itemStringYesqtyQuantity of itemsFloatYesmuMeasuring unit (hour/piece/kg/...)StringYespricePrice per unitFloatYesvatValue Added TaxFloatYesdiscountDiscount in percentageFloatNo--- ***Add payment*** KeyDescriptionFormatRequireddate\_ofDate of paymentDate (d.m.Y)YesamountTotal amount paid (calculated automatically if left out)FloatNoid\_payment\_methodPayment method ID (1: Credit card, 2: Cash)IntegerYes--- ***Fiscalize invoice*** In Slovenia you need to fiscalize (send to Tax office) all "Cash" invoices in realtime. Invoice is considered "Cash" invoice when it is not paid by direct transaction to your bank account (wire transfer) or PayPal. - Non "Cash" payments **CAN** be fiscalized - "Cash" payments **MUST** be fiscalized. KeyDescriptionFormatRequiredid\_locationFiscal invoice predefined location. Location must be registered at Tax officeString/IntegerYesfiscalizeDetermine if invoice is fiscalized0/1Noop-tax-idPersonal tax ID of the person/company issuing an invoiceStringYesop-nameOperators name that is printed on invoiceStringYes--- ***Generate PDF of an invoice*** Get the binary data of PDF from the server. Parameters: - Path to storage folder - Document title --- Examples -------- [](#examples) --- - Registering location ``` $beezAPI = new Beez(); $beezAPI->addLocation([ 'type' => 'C', 'location_id' => 'UniqueLocation1245', 'register_id' => 'UniqueRegister1254', 'test_mode' => 1 ]); echo $beezApi->getLocation(); ``` --- - Set currency ``` $beezAPI->setCurrency(Currency::HRK); ``` --- - Basic making of an invoice and generating PDF ``` $beezAPI = new Beez(); $beezAPI->insertCustomer([ 'name' => 'Name Surname', 'street' => 'Test Street 42', 'postal' => '1000', 'city' => 'Test City', 'country' => 'Test Country' ])->insertHead([ 'date_sent' => Carbon::now()->format("d.m.Y"), 'date_served' => Carbon::now()->format("d.m.Y"), 'date_to_pay' => Carbon::now()->addDay()->format("d.m.Y"), 'date_payed' => Carbon::now()->addDay()->format("d.m.Y"), 'payment' => 'paid', ])->insertItems([ [ 'title' => "Item 1", 'qty' => 1, 'mu' => 'kg', 'price' => 12, 'vat' => 22 ], [ 'title' => "Service 1", 'qty' => 1.24, 'mu' => 'piece', 'price' => 42.5, 'vat' => 9.5, 'discount' => 10.5 ] ])->insertPayment([ 'date_of' => Carbon::now()->addDay()->format("d.m.Y"), 'amount' => 54.5, 'id_payment_method' => PaymentOptions::CREDIT_CARD, ])->fiscalizeInvoice([ 'id_location' => 12, 'fiscalize' => 1, 'op-tax-id' => '123456789', 'op-name' => 'Operator' ])->generatePDF('path/to/pdf/', 'PDF Title'); ``` --- ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community11 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/7dc86bd58ba2ef017d8e5c7dc47d0ddc96b67445210fba8ff213c99fe7a31c79?d=identicon)[mare06xa](/maintainers/mare06xa) --- Top Contributors [![markoKodric](https://avatars.githubusercontent.com/u/18535475?v=4)](https://github.com/markoKodric "markoKodric (20 commits)")[![markoKodric9](https://avatars.githubusercontent.com/u/23375973?v=4)](https://github.com/markoKodric9 "markoKodric9 (4 commits)") ### Embed Badge ![Health badge](/badges/mare06xa-beez/health.svg) ``` [![Health](https://phpackages.com/badges/mare06xa-beez/health.svg)](https://phpackages.com/packages/mare06xa-beez) ``` ### Alternatives [omnipay/paypal PayPal gateway for Omnipay payment processing library 3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto Biblioteca com boletos para o laravel 626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money. 1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php 2Checkout PHP Library 83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data Generate QR code data for SEPA payments 61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy Dummy driver for the Omnipay payment processing library 271.2M33](/packages/omnipay-dummy) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)