# French E-Invoice Preparation

Prepares public company identifiers and a category-based reference schedule for French e-invoicing workflows.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/e-invoice`
- Price: `0.020 USD` / call

## Machine discovery

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Coverage

FR

## Use when

- Prepare public identity fields for a French electronic-invoicing workflow.
- You need public company identifiers and a category-based reference schedule for a French e-invoicing workflow.
- You want headquarters SIRET, VAT number and indicative receiving/issuing obligation dates together.

## Avoid when

- You are checking identifiers already printed on a supplier invoice; use company/fr/invoice-check.
- You only need the company’s current public profile; use company/fr/profile.

## Limitations

- The schedule is derived from public company-category information and the implemented reference rules.
- It does not confirm enrollment with a specific invoicing platform or guarantee operational readiness.

## Example queries

- Prepare public identity fields for a French electronic-invoicing workflow.

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [API Recherche d’entreprises](https://recherche-entreprises.api.gouv.fr)
- [HelpMyAgent public-data composition](https://helpmyagent.com)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "French company identifier: 9-digit SIREN or 14-digit SIRET."
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier"
    ],
    "description": "Structured input parameters for the company/fr/e-invoice API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "description": "Identifier supplied for the request, echoed in normalized form when applicable."
        },
        "exists": {
            "type": "boolean",
            "description": "Whether the requested company or public record was found in the checked source."
        },
        "siren": {
            "type": [
                "string",
                "null"
            ],
            "description": "Normalized 9-digit French SIREN when available."
        },
        "name": {
            "type": [
                "string",
                "null"
            ],
            "description": "Publicly available company, person, buyer or record name for this result."
        },
        "company_category": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “company category” as defined by this API contract."
        },
        "vat_number": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “vat number” as defined by this API contract."
        },
        "headquarters_siret": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “headquarters siret” as defined by this API contract."
        },
        "headquarters_address": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “headquarters address” as defined by this API contract."
        },
        "receiving_obligation_from": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “receiving obligation from” as defined by this API contract."
        },
        "issuing_obligation_from": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “issuing obligation from” as defined by this API contract."
        },
        "establishment_scope": {
            "type": "string",
            "description": "Structured value returned for “establishment scope” as defined by this API contract."
        },
        "prepared_at": {
            "type": "string",
            "description": "Structured value returned for “prepared at” as defined by this API contract."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier",
        "exists",
        "siren",
        "name",
        "company_category",
        "vat_number",
        "headquarters_siret",
        "headquarters_address",
        "receiving_obligation_from",
        "issuing_obligation_from",
        "establishment_scope",
        "prepared_at"
    ],
    "description": "Structured result returned by the company/fr/e-invoice API."
}
```

## Demonstration snapshot

This example is a database-stored snapshot and does not execute the live API.
- URL: https://api.helpmyagent.com/demo/company/fr/e-invoice
- Generated at: 2026-09-07T14:50:12+00:00

## Request example

```json
{
    "identifier": "356000000"
}
```

## Stored response example

```json
{
    "identifier": "356000000",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "company_category": "GE",
    "vat_number": "FR39356000000",
    "headquarters_siret": "35600000000048",
    "headquarters_address": "DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL PIERRE AVIA 75015 PARIS",
    "receiving_obligation_from": "2026-09-01",
    "issuing_obligation_from": "2026-09-01",
    "establishment_scope": "headquarters_only",
    "prepared_at": "2026-09-07T16:50:12+02:00",
    "limitations": [
        "Le calendrier est appliqué uniquement lorsque l’entreprise est résolue et que sa catégorie publique permet de déterminer l’échéance d’émission.",
        "Une catégorie inconnue reste inconnue : aucune date d’émission n’est déduite par défaut.",
        "Le SIRET retourné couvre le siège ; la liste exhaustive des établissements n’est pas déduite lorsque la source publique ne la garantit pas.",
        "Cette réponse ne constitue pas un avis fiscal ou juridique."
    ]
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_empty_result": true,
    "no_charge_on_error": true
}
```