VAVANG INVOICE / DOCS / FR

Configuration

Commencez par une configuration sûre et explicite. La transmission reste en MANUAL tant que l’onboarding fiscal et les diagnostics ne sont pas validés.

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

Référence des options

Option	Type	Défaut	Rôle
`seller_company.*`	chaîne ou `null`	`null`	Identité fiscale du vendeur : raison sociale, SIREN/SIRET, TVA, adresse, territoire et devise.
`seller_company.vat_filing_frequency`	enum	`MONTHLY`	Fréquence déclarative TVA.
`seller_company.vat_exigibility`	enum ou `null`	`null`	Exigibilité TVA pour les opérations de service.
`legal_entities`	map	`[]`	Entités juridiques supplémentaires indexées par code stable.
`channel_legal_entities`	map	`[]`	Association d’un canal Sylius à une entité juridique.
`default_legal_entity`	chaîne ou `null`	`null`	Entité juridique de repli lorsqu’aucun mapping de canal n’existe.
`product_nature.default`	enum `GOODS`/`SERVICE`	`GOODS`	Nature fiscale par défaut d’une variante.
`product_nature.variants`	map	`[]`	Surcharges de nature fiscale par code variante.
`platform.active`	chaîne ou `null`	`null`	Code du connecteur de plateforme actif.
`platform.environment`	enum	`SANDBOX`	Environnement d’exécution du connecteur.
`platform.endpoint`	chaîne ou `null`	`null`	Endpoint fournisseur lorsqu’il doit être surchargé.
`platform.organization_id`	chaîne ou `null`	`null`	Identifiant d’organisation côté fournisseur.
`platform.credentials`	map de références d’environnement	`[]`	Noms de variables d’environnement contenant les secrets, jamais les secrets eux-mêmes.
`platform.options`	map	`[]`	Options non secrètes propres au fournisseur.
`transmission.mode`	enum	`MANUAL`	Mode d’envoi. Restez en manuel pendant l’onboarding.
`transmission.connector`	chaîne ou `null`	`null`	Compatibilité Beta 1 ; préférez `platform.active`.
`transmission.retry.max_retries`	entier ≥ 0	`3`	Nombre maximum de nouvelles tentatives.
`transmission.retry.delay_ms`	entier ≥ 0	`1000`	Délai initial en millisecondes.
`transmission.retry.multiplier`	flottant ≥ 1	`2.0`	Multiplicateur du backoff.
`transmission.retry.max_delay_ms`	entier ≥ 0	`10000`	Plafond du délai de retry.
`retention.webhook_receipts_days`	entier ≥ 1	`30`	Durée de conservation des reçus webhook déjà traités.
`retention.provider_payload_days`	entier ≥ 1	`30`	Durée de conservation des payloads fournisseur bruts en erreur.

Décision fiscale versus représentation technique

Le plugin sait valider des valeurs supportées ; il ne choisit pas à la place du marchand son régime de TVA, son exigibilité ou le traitement territorial applicable. Ces choix doivent être confirmés avec les interlocuteurs fiscaux compétents.

Avant l’automatisation

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

Résolvez les erreurs bloquantes avant de configurer une plateforme et de passer en transmission automatique.