VAVANG INVOICE / DOCS / EN

Configuration

Start from a safe, explicit configuration. Keep transmission in MANUAL until fiscal onboarding and diagnostics are validated.

sylius_invoice:
    seller_company:
        legal_name: 'Acme France SAS'
        siren: '732829320'
        siret: '73282932000074'
        vat_number: 'FR44732829320'
        address_line1: '1 rue de la Paix'
        postal_code: '75002'
        city: 'Paris'
        country_code: 'FR'
        territory_code: 'FR-METROPOLE'
        currency_code: 'EUR'
        tax_regime: 'REAL_NORMAL'
        vat_filing_frequency: 'MONTHLY'
        vat_exigibility: 'ON_RECEIPTS'

    product_nature:
        default: GOODS
        variants:
            CONSULTING-001: SERVICE

    transmission:
        mode: MANUAL
        retry:
            max_retries: 3
            delay_ms: 1000
            multiplier: 2.0
            max_delay_ms: 10000

Option reference

Option	Type	Default	Purpose
`seller_company.*`	string or `null`	`null`	Seller fiscal identity: legal name, SIREN/SIRET, VAT, address, territory and currency.
`seller_company.vat_filing_frequency`	enum	`MONTHLY`	VAT filing frequency.
`seller_company.vat_exigibility`	enum or `null`	`null`	VAT exigibility for service operations.
`legal_entities`	map	`[]`	Additional legal entities keyed by a stable code.
`channel_legal_entities`	map	`[]`	Maps a Sylius channel to a legal entity.
`default_legal_entity`	string or `null`	`null`	Fallback legal entity when no channel mapping exists.
`product_nature.default`	`GOODS`/`SERVICE` enum	`GOODS`	Default fiscal nature for a variant.
`product_nature.variants`	map	`[]`	Fiscal-nature overrides keyed by variant code.
`platform.active`	string or `null`	`null`	Code of the active platform connector.
`platform.environment`	enum	`SANDBOX`	Connector execution environment.
`platform.endpoint`	string or `null`	`null`	Provider endpoint override when needed.
`platform.organization_id`	string or `null`	`null`	Provider-side organization identifier.
`platform.credentials`	map of environment references	`[]`	Environment-variable names containing secrets; never secret values themselves.
`platform.options`	map	`[]`	Non-secret provider-specific options.
`transmission.mode`	enum	`MANUAL`	Sending mode. Keep manual during onboarding.
`transmission.connector`	string or `null`	`null`	Beta 1 compatibility; prefer `platform.active`.
`transmission.retry.max_retries`	integer ≥ 0	`3`	Maximum retry count.
`transmission.retry.delay_ms`	integer ≥ 0	`1000`	Initial retry delay in milliseconds.
`transmission.retry.multiplier`	float ≥ 1	`2.0`	Backoff multiplier.
`transmission.retry.max_delay_ms`	integer ≥ 0	`10000`	Maximum retry delay.
`retention.webhook_receipts_days`	integer ≥ 1	`30`	Retention for already-processed webhook receipts.
`retention.provider_payload_days`	integer ≥ 1	`30`	Retention for raw provider error payloads.

Fiscal decision versus technical representation

The plugin can validate supported values; it does not choose the merchant’s VAT regime, exigibility or territorial tax treatment. Those decisions must be confirmed with the appropriate fiscal advisers.

Before automation

bin/console sylius-invoice:check-requirements
bin/console sylius-invoice:compliance:doctor

Resolve blocking errors before configuring a platform and enabling automatic transmission.