Documentation

TalerProductLink extends CommonObject

in package

• TalerBarr

Class TalerProductLink

Tags

license

https://www.gnu.org/licenses/ GNU Affero General Public License v3 or later

Table of Contents

Properties

$checksum_d_hex  : mixed

$checksum_t_hex  : mixed

$datec  : mixed

$element  : string

$entity  : mixed

$fields  : mixed

$fk_product  : mixed

$fk_unit  : mixed

$isextrafieldmanaged  : int

$ismultientitymanaged  : int|string

$last_error_code  : mixed

$last_error_message  : mixed

$last_sync_at  : mixed

$last_sync_status  : mixed

$lastsync_is_push  : mixed

$module  : string

$picto  : string

$price_is_ttc  : mixed

$product_ref_snap  : mixed

$product_tms_snap  : mixed

$rowid  : mixed

$sync_enabled  : mixed

$syncdirection_override  : mixed

$table_element  : string

$taler_address_json  : mixed

$taler_amount_str  : mixed

$taler_categories_json  : mixed

$taler_currency  : mixed

$taler_description  : mixed

$taler_fraction  : mixed

$taler_image_hash  : mixed

$taler_instance  : mixed

$taler_minimum_age  : mixed

$taler_next_restock  : mixed

$taler_product_id  : mixed

$taler_product_name  : mixed

$taler_taxes_json  : mixed

$taler_total_lost  : mixed

$taler_total_sold  : mixed

$taler_total_stock  : mixed

$taler_value  : mixed

$tms  : mixed

Methods

__construct()  : mixed

Constructor

amountStrFromPrice()  : string

Convert a numeric price to the Taler “amount” string, e.g. 12.5 EUR → "EUR:12.50".

buildVatDiagnosis()  : array<string, mixed>

Derive VAT diagnostics and a safe tax suggestion for UI warnings.

computeSha256Hex()  : string

Compute SHA-256 hex of normalized data

create()  : int

Create record in database

createDolibarrProductFromTalerDetail()  : int

Create a Dolibarr Product from a Taler ProductDetail and (optionally) create the link row.

delete()  : int

Delete object from database

deleteOnTaler()  : bool

Delete the product on the Taler backend.

dolibarrArrayFromTalerDetail()  : array<string|int, mixed>

Create a Dolibarr product "field array" from a Taler ProductDetail.

fetch()  : int

Fetch object from database

fetchByInstancePid()  : int

Fetch by Taler instance and product id

fetchByProductId()  : int

Fetch by Dolibarr product id

fillPriceFromAmountStr()  : void

Populate price fields from taler_amount_str

getLabelForList()  : string

Build a concise label for lists.

getNomUrl()  : string

Get HTML link for this object (standard Dolibarr pattern).

markSyncResult()  : void

Mark synchronization result

parseTalerAmount()  : array<string|int, mixed>

Parse Taler amount string

prepareFromDolibarrAndTalerDetail()  : $this

Prepare this link row from a Dolibarr product AND a Taler ProductDetail (partial or full).

pullFromTaler()  : bool

Pull latest product data from Taler and (optionally) update Dolibarr.

pushToTaler()  : bool

Push (create or update) the linked Dolibarr product to the Taler inventory.

setDolibarrSnapshot()  : void

Save Dolibarr product reference + timestamp snapshot

talerAmountFromFloat()  : string

Build Taler amount string from float

talerDetailFromDolibarrProduct()  : array<string|int, mixed>

Build a Taler ProductDetail array from a Dolibarr Product.

talerPayloadFromDolibarr()  : array<string|int, mixed>

Backward-compatible payload wrapper

update()  : int

Update object into database

upsertFromDolibarr()  : int

Idempotent upsert driven by a *Dolibarr* product.

upsertFromTaler()  : int

Idempotent upsert driven by a *Taler* ProductDetail array/object.

_canon()  : string

Deterministic JSON encoding for hash calculation.

_checksumDoli()  : string

Compute SHA-256 on a subset of Dolibarr product fields (canonicalized).

amountStringToFloat()  : float|null

Convert "CUR:amount" into float, null on error.

applyVatToProduct()  : void

Apply VAT details to a Product object.

buildTaxesForDolibarrProduct()  : array<string|int, mixed>

Build a spec-compliant Tax[] array from a Dolibarr product line.

fetchVatDetails()  : array<string, mixed>|null

Fetch VAT details from c_tva to apply on Product.

findNearestVat()  : array{fk_c_tva: int, rate: float, diff: float}|null

Find the nearest active VAT line in Dolibarr's dictionary.

getMerchantClient()  : TalerMerchantClient|null

Build a ready-to-use TalerMerchantClient for this link.

guessDecimalsFromAmount()  : int

Guess how many decimals are present in a Taler amount string.

log()  : void

Lightweight logger wrapper to keep messages consistent.

logTalerError()  : void

Lightweight wrapper to persist an error row (if the table/class exists).

parseTaxAmountToFloat()  : float|null

Parse a tax amount coming from Taler into float, updating decimals/currency hints.

resolveInstanceFromConfig()  : string

Resolve instance from TalerConfig if available

resolveUnitCodeById()  : string

Get unit code from fk_unit

resolveUnitIdByCode()  : int|null

Get unit id from code

resolveVatFromTalerTaxes()  : array{rate: float|null, fk_c_tva: int|null}

Try to resolve VAT rate/fk_c_tva from Taler taxes + price.