{"uid":"cap_1Hvo4Gmop-AQVPohdb350","slug":"french-e-invoicing-compliance-check-invoice-ready-0fa372c2","name":"French E-Invoicing Compliance Check (invoice-ready)","description":"One-call compliance check for the French e-invoicing reform (from 2026-09-01 the customer's SIREN is a mandatory invoice mention). Query: ?siren=552032534 or ?siret=55203253400041. Runs the Luhn checksum, confirms existence and active status in the official SIRENE registry, computes the FR VAT number and validates it live against VIES. Returns a single verdict: ready / not_ready / check_vat_manually (VIES flakiness never blocks the answer). 1h cache.","url":"https://data.greeneris.io/v1/fr/invoice-ready","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"siren":{"type":"string","description":"9-digit SIREN (this or siret is required)"},"siret":{"type":"string","description":"14-digit SIRET; the SIREN is extracted from it"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"siren":"552032534","active":true,"exists":true,"source":"recherche-entreprises.api.gouv.fr (INSEE Sirene) + VIES REST API (European Commission); Luhn checksum and FR VAT key computed locally","details":"SIREN checksum OK, company registered and active in SIRENE, computed VAT number FR27552032534 confirmed valid by VIES.","verdict":"ready","legal_name":"DANONE","vat_number":"FR27552032534","vat_status":"valid","invoice_ready":true,"checksum_valid":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BjjrqpHN7Ny3V9seFQ861","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a French company's SIREN/SIRET for e-invoicing readiness: Luhn checksum, SIRENE registry existence/active status, FR VAT number computation, and live VIES validation — returning a single ready/not_ready/check_vat_manually verdict.","exampleAgentPrompt":"Before I send this invoice, can you check if SIREN 552032534 is ready for French e-invoicing — confirm it's active in the SIRENE registry and that its VAT number is valid?","exampleUseCases":[{"title":"Pre-invoice supplier compliance check","prompt":"I'm about to pay a French supplier and need to issue a compliant e-invoice. Can you check if SIRET 55203253400041 is active, passes all the mandatory checks, and is ready for the 2026 French e-invoicing reform?"},{"title":"Onboarding French business partner validation","prompt":"We're onboarding a new French vendor with SIREN 552032534 — can you verify they exist in the official SIRENE registry, are still active, and that their EU VAT number is valid on VIES?"},{"title":"Automated accounts payable invoice gate","prompt":"Before our AP system processes this invoice, check whether SIREN 348418931 is e-invoicing ready — I need a clear verdict so we know whether to accept or flag it for manual review."}],"resultDescription":"A JSON object with a single top-level verdict field: 'ready' (company exists, is active, and VAT is confirmed), 'not_ready' (company does not exist or is inactive), or 'check_vat_manually' (SIRENE checks passed but VIES was unavailable). Also includes the computed French VAT number and supporting SIRENE/VIES detail fields. Results are cached for 1 hour.","failureModes":["Invalid SIREN format (not 9 digits) or failed Luhn checksum — returns validation error","Neither siren nor siret query parameter provided — returns 400-style error","SIREN not found in SIRENE registry — verdict: not_ready","Company found but marked inactive/ceased in SIRENE — verdict: not_ready","VIES unavailable or flaky — verdict: check_vat_manually (never hard-blocks the response)","Malformed SIRET (not 14 digits) — returns validation error"],"whenToPreferThis":"Choose this endpoint when you need a single, authoritative go/no-go verdict on whether a French company is compliant with the mandatory 2026 French e-invoicing reform (SIREN as a mandatory invoice mention). It combines Luhn checksum, SIRENE registry lookup, FR VAT computation, and live VIES validation into one call, eliminating the need to chain multiple APIs. Prefer it over generic VAT checkers or SIRENE-only lookups when you need the full compliance picture with graceful VIES fallback.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:57.038Z","isFirstParty":false}