> ## Documentation Index
> Fetch the complete documentation index at: https://docs.umeme.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Renvoyer le rappel

> Renvoie le dernier rappel d'une vente à statut final, signé à nouveau. Possible pendant 90 jours. Le rappel garde son identifiant d'événement : votre dédoublonnage le reconnaît.

Portée de la clé : `ventes:ecrire`.



## OpenAPI

````yaml openapi/v1.json POST /v1/ventes/{uuid}/rappel
openapi: 3.1.0
info:
  title: API Umeme pour les intégrateurs
  version: 1.0.0
  description: >-
    Contrat de l'API Umeme pour les intégrateurs : vendre de l'électricité
    prépayée et des abonnements TV depuis le portefeuille de votre revendeur.
servers:
  - url: https://sandbox.umeme.app
    description: Sandbox d'intégration
  - url: https://api.umeme.app
    description: Production
security:
  - cle: []
tags:
  - name: Ventes
  - name: Compteurs
  - name: Portefeuille
  - name: Outils
paths:
  /v1/ventes/{uuid}/rappel:
    post:
      tags:
        - Ventes
      summary: Renvoyer le rappel
      description: >-
        Renvoie le dernier rappel d'une vente à statut final, signé à nouveau.
        Possible pendant 90 jours. Le rappel garde son identifiant d'événement :
        votre dédoublonnage le reconnaît.


        Portée de la clé : `ventes:ecrire`.
      operationId: renvoyerRappel
      parameters:
        - $ref: '#/components/parameters/Uuid'
      responses:
        '202':
          description: Le rappel part.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RappelRenvoye'
              example:
                uuid: 94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb
                evenementId: evt_01JC9W3Z7Q8T5N2M4K6P0R1S3V
                renvoyeLe: '2026-11-07T09:02:11Z'
        '401':
          $ref: '#/components/responses/NonAuthentifie'
        '404':
          description: Aucune vente avec cet `uuid`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
              example:
                code: NON_TROUVEE
                message: Aucune vente avec cet uuid.
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            UUID="94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb"

            curl -X POST "$UMEME_BASE_URL/ventes/$UUID/rappel" \
              -H "Authorization: Bearer $UMEME_CLE"
        - lang: javascript
          label: Node.js · fetch
          source: |-
            // Node.js 18 et plus : fetch est intégré.
            const baseUrl = process.env.UMEME_BASE_URL;

            const uuid = "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb";

            const reponse = await fetch(`${baseUrl}/ventes/${uuid}/rappel`, {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.UMEME_CLE}`,
              },
            });
            const donnees = await reponse.json();
        - lang: javascript
          label: Node.js · Axios
          source: |-
            // npm install axios
            import axios from "axios";

            const umeme = axios.create({
              baseURL: process.env.UMEME_BASE_URL,
              headers: { Authorization: `Bearer ${process.env.UMEME_CLE}` },
              timeout: 30000,
            });

            const uuid = "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb";

            const { data } = await umeme.post(`/ventes/${uuid}/rappel`);
        - lang: python
          label: Python
          source: |-
            import os

            import requests

            BASE_URL = os.environ["UMEME_BASE_URL"]
            ENTETES = {"Authorization": f"Bearer {os.environ['UMEME_CLE']}"}

            uuid = "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb"

            reponse = requests.post(
                f"{BASE_URL}/ventes/{uuid}/rappel",
                headers=ENTETES,
                timeout=30,
            )
            donnees = reponse.json()
        - lang: php
          label: PHP
          source: |-
            // composer require guzzlehttp/guzzle
            $client = new GuzzleHttp\Client([
                'base_uri' => getenv('UMEME_BASE_URL') . '/',
                'headers' => ['Authorization' => 'Bearer ' . getenv('UMEME_CLE')],
                'timeout' => 30,
            ]);

            $uuid = '94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb';

            $reponse = $client->post("ventes/{$uuid}/rappel");
            $donnees = json_decode($reponse->getBody(), true);
        - lang: java
          label: Java
          source: >-
            // Java 15 et plus : java.net.http et blocs de texte.

            var baseUrl = System.getenv("UMEME_BASE_URL");

            var client = HttpClient.newHttpClient();


            var uuid = "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb";


            var requete = HttpRequest.newBuilder(URI.create(baseUrl + "/ventes/"
            + uuid + "/rappel"))
                .header("Authorization", "Bearer " + System.getenv("UMEME_CLE"))
                .POST(HttpRequest.BodyPublishers.noBody())
                .build();

            var reponse = client.send(requete,
            HttpResponse.BodyHandlers.ofString());
components:
  parameters:
    Uuid:
      name: uuid
      in: path
      required: true
      description: L'identifiant que vous avez donné à la vente.
      schema:
        type: string
        format: uuid
      example: 94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb
  schemas:
    RappelRenvoye:
      type: object
      required:
        - uuid
        - evenementId
        - renvoyeLe
      properties:
        uuid:
          type: string
          format: uuid
          description: L'identifiant de la vente.
        evenementId:
          type: string
          description: L'identifiant de l'événement, le même que celui du rappel d'origine.
        renvoyeLe:
          type: string
          format: date-time
          description: Heure du renvoi, en UTC.
    Erreur:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: 'Stable : il ne se renomme jamais. C''est lui que votre code compare.'
        message:
          type: string
          description: En français, pour vos journaux. Il peut changer.
  responses:
    NonAuthentifie:
      description: >-
        Clé absente, inconnue, révoquée, ou de l'autre environnement :
        `CLE_INVALIDE`, `CLE_REVOQUEE`, `CLE_MAUVAIS_ENVIRONNEMENT`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erreur'
          example:
            code: CLE_INVALIDE
            message: La clé est absente ou inconnue.
  securitySchemes:
    cle:
      type: http
      scheme: bearer
      description: >-
        Votre clé d'API : `umeme_test_…` dans la sandbox, `umeme_live_…` en
        production.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.