> For the complete documentation index, see [llms.txt](https://ouvretaferme.gitbook.io/ouvretaferme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production.md).

# Production

- [Actions et matériel](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/actions-et-materiel.md): De quoi décrire le travail aux champs : les actions réalisables sur vos cultures, leurs catégories et leurs méthodes, le matériel qui les outille et vos fournisseurs de semences et plants.
- [Actions](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/actions-et-materiel/actions.md): Les actions réalisables sur vos cultures (semis, désherbage, récolte...). Chaque intervention du planning est une occurrence d'une action.
- [Catégories d'action](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/actions-et-materiel/categories-daction.md): Les catégories utilisées pour regrouper vos actions.
- [Fournisseurs de semences et plants](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/actions-et-materiel/fournisseurs-de-semences-et-plants.md): Les fournisseurs de semences et de plants utilisés pour vos variétés.
- [Matériel](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/actions-et-materiel/materiel.md): Le matériel utilisé pour réaliser vos interventions (outils, équipements...). La liste écarte les matériels supprimés, que ?status=deleted retrouve. Supprimer un matériel que cite une intervention, un itinéraire ou le carnet d'entretien ne l'efface pas, il passe au statut deleted et le carnet arrête de le suivre.
- [Méthodes de travail](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/actions-et-materiel/methodes-de-travail.md): Les méthodes de travail associées à une action (ex. techniques ou outils spécifiques utilisés pour la réaliser).
- [Aides agricoles](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/aides-agricoles.md): Le catalogue des aides agricoles de la Boîte à outils, tel que l'outil le montre à votre structure : les aides en cours, leur fiche et les organismes qui les accordent. Il est le même pour tout le monde et ne se modifie pas. Sans critère, la liste reprend ceux de l'outil pour votre structure (son département, ou le périmètre d'un réseau, et le bio), que la réponse rend dans filters. Sans critère de production, elle couvre toutes les productions.
- [Aides](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/aides-agricoles/aides.md): Les aides que l'outil affiche : publiées, ouvertes ou à venir, annuelles entre deux campagnes, ou sans démarche. Une aide close, archivée ou en préparation n'existe pas ici. Sans critère, la liste reprend ceux de l'outil pour votre structure ; un critère vide les retire, si bien que department= vide cherche dans toute la France. La liste se range par identifiant. La fiche d'une aide en dit plus, comme dans l'outil : conditions, démarche, pièces et contact. Le contact ne donne pas d'adresse électronique, que la fiche de l'aide affiche dans l'outil, et un texte qui en cite une la remplace par « \[adresse sur la fiche de l'aide] ».
- [Organismes](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/aides-agricoles/organismes.md): Les organismes qu'une aide affichée nomme : celui qui l'accorde, ses financeurs et cofinanceurs, le guichet qui reçoit le dépôt et l'organisme qui l'instruit. Leur contact se lit dans celui de l'aide.
- [Boite à outils](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils.md): Les outils de la Boite à outils qui portent des données propres à votre structure. La pluviométrie, avec vos pluviomètres et leurs relevés, le carnet d'entretien du matériel, avec les matériels suivis, les relevés de leur compteur, leurs entretiens planifiés et leur historique, et la consommation d'eau, avec vos compteurs d'eau et leurs relevés. On y trouve aussi le catalogue E-Phy des produits phytopharmaceutiques sur lequel repose le carnet de traitement, qui n'est la donnée de personne en particulier.
- [Catalogue E-Phy](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/catalogue-e-phy.md): Les produits phytopharmaceutiques du catalogue E-Phy de l'ANSES, rechargé chaque semaine : les produits autorisés, et les produits retirés tant qu'un de leurs usages reste utilisable. Ce catalogue est le même pour tout le monde et ne se modifie pas. Le produit que votre structure note est un matériel à routine phyto, qui n'en garde que le numéro d'AMM.
- [Compteurs d'eau](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/compteurs-deau.md): Les compteurs d'eau de la structure, chacun avec un nom et le nombre de chiffres qu'il affiche pour les m³ entiers. Ce nombre de chiffres borne les relevés du compteur, et dit ce qu'il a compté quand il repasse par zéro. Il ne descend pas sous le plus haut relevé du compteur en place, et un compteur remplacé dans l'écran garde pour ses anciens relevés le nombre de chiffres qu'il avait. Deux compteurs actifs ne portent pas le même nom. Il n'y a pas de suppression. Supprimer un compteur le passe au statut inactive et lui garde ses relevés. Une modification nomme ce qu'elle change dans properties. Un corps sans properties est lu comme une modification complète, qui attend toutes les propriétés, status compris, et la seule valeur que status accepte est inactive. Un compteur inactif refuse ensuite toute modification, comme ses relevés, avec un code 412.
- [Entretiens faits](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/entretiens-faits.md): L'historique d'un matériel suivi. Une ligne qui nomme un entretien planifié dit qu'il a été fait ce jour-là. Elle fait repartir son échéance, ou le clôt s'il se fait une seule fois, et name reste à null. Avec maintenance à null, la ligne est une intervention, qui n'entre qu'à l'historique sous le libellé donné dans name. L'entretien nommé est un entretien encore actif du matériel donné. À la création, value à null prend le compteur dans les relevés du matériel. Quand le matériel n'a aucun relevé, la ligne d'un entretien dû au compteur seul doit donner value, et elle est refusée sans lui. Une valeur donnée devient aussi le relevé de ce jour et suit la règle d'un relevé. Un compteur ne recule pas, et le même appel renvoyé avec "confirmed": true dans le corps est accepté. Une modification ne change ni le matériel, ni l'entretien, et value ne s'y donne pas. Quand la date d'une ligne change, value est relu dans les relevés du matériel à la nouvelle date, et le relevé de l'ancien jour reste. Sur un matériel dont le compteur a été retiré, la ligne déplacée garde value et l'échéance au compteur de l'entretien reste celle qu'il portait. Un entretien fait pendant que le compteur est retiré ne fait pas repartir son échéance au compteur. Supprimer la ligne de la dernière fois où l'entretien a été fait fait repartir son échéance de la fois d'avant. Quand la ligne supprimée était la seule, l'échéance d'un entretien régulier reste celle qui avait été calculée, et se corrige sur l'entretien par plannedDate et plannedValue, donnés ensemble. Un jour à venir est refusé. Une ligne créée, déplacée ou supprimée avant la dernière fois où l'entretien a été fait n'entre qu'à l'historique et ne change pas son échéance. Quand l'échéance repart d'une ligne, un retard ignoré avant la date de cette ligne est oublié, et ignoredDate revient à null. Un compteur donné sur un matériel sans compteur est refusé, et value est rendu à null quand aucun relevé ne précède la date. Le relevé posé par une ligne reste quand la ligne est supprimée ou change de date. Un entretien à faire une seule fois redevient à faire quand sa ligne est supprimée. Deux créations identiques font deux lignes. Sur la ligne d'un entretien planifié, name ne se modifie pas et reste à null. Les lignes d'un matériel inactif ne se modifient et ne se suppriment plus, ce que dit un code 412. La photo d'un entretien ne passe pas par l'API.
- [Entretiens planifiés](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/entretiens-planifies.md): Les entretiens à faire sur un matériel suivi, dus à une date, à une valeur du compteur, ou au premier des deux. Un entretien revient régulièrement quand il porte une fréquence, au compteur ou en mois, et se fait une seule fois quand les deux fréquences sont à null. Les valeurs au compteur demandent un matériel à compteur. Il n'y a pas de suppression, retirer un entretien le passe au statut deleted. Une modification nomme ce qu'elle change dans properties, les deux fréquences ensemble et les deux échéances ensemble. Un corps sans properties est lu comme une modification complète, qui attend toutes les propriétés, status compris, et la seule valeur que status accepte est deleted. La liste écarte les entretiens retirés, que ?status=deleted retrouve.
- [Matériels suivis](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/materiels-suivis.md): Les matériels que suit le carnet d'entretien, avec un compteur d'heures, de kilomètres, ou sans compteur. Suivre un matériel demande qu'il existe déjà dans la ressource tool, et il ne se suit qu'une fois. Il n'y a pas de suppression. Ne plus suivre un matériel le passe au statut inactive et lui garde ses relevés et son historique. Une modification nomme ce qu'elle change dans properties. Un corps sans properties est lu comme une modification complète, qui attend toutes les propriétés, status compris, et la seule valeur que status accepte est inactive. Un matériel inactif refuse ensuite toute modification, comme ses relevés, avec un code 412. POST equipment sur le même matériel le reprend avec son identifiant au lieu d'en créer un second, et répond alors 200 au lieu de 201. Un matériel qui porte des valeurs de compteur ne change plus d'unité. L'immatriculation est facultative, tient en 20 caractères et se relit en capitales.
- [Pluviomètres](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/pluviometres.md): Les emplacements où la pluie est relevée : une zone du parcellaire, ou la ferme entière quand la pluie n'est pas relevée zone par zone. Un lieu ne reçoit qu'un pluviomètre actif à la fois. Retirer un pluviomètre le passe inactif et lui garde ses relevés, ce qui se fait en modifiant son statut : il n'y a pas de suppression.
- [Relevés de compteur](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/releves-de-compteur.md): Ce que le compteur d'un matériel suivi affiche un jour donné, dans l'unité du matériel. Il n'y a qu'un relevé par matériel et par jour : créer un relevé remplace celui du jour, et répond 200 avec le relevé du jour. Le premier relevé d'un matériel fait repartir de sa valeur les entretiens réguliers au compteur dont plannedValue lui est inférieur ou égal, qui deviennent dus à cette valeur augmentée de everyValue, pour qu'ils ne soient pas en retard dès la première saisie. Les relevés suivants ne changent aucune échéance. Un compteur ne recule pas. Un relevé inférieur à un relevé plus ancien, ou supérieur à un relevé plus récent, est refusé. Pour corriger une erreur, le même appel renvoyé avec "confirmed": true dans le corps est accepté. Une modification ne change que la valeur. Les relevés d'un matériel inactif ne se créent, ne se modifient et ne se suppriment plus, ce que dit un code 412.
- [Relevés de compteur d'eau](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/releves-de-compteur-deau.md): Ce qu'un compteur d'eau affiche un jour donné, en m³, au dixième. Un relevé n'est pas une consommation. La consommation est l'écart entre deux relevés qui se suivent. Il n'y a qu'un relevé par compteur et par jour : créer un relevé remplace celui du jour, et répond 200 avec le relevé du jour. Un relevé plus bas que le précédent est accepté. Il dit que le compteur a fait le tour, et la consommation se compte alors en passant par zéro, avec le nombre de chiffres du compteur. Un relevé reste sous ce que ce nombre de chiffres permet d'afficher. Un jour à venir est refusé. Quand le compteur a été remplacé, le relevé du jour du changement porte changed, sa valeur est ce que le nouveau compteur affichait à sa pose, d'où les relevés suivants se comptent, et changedValue ce que l'ancien affichait à sa dépose, vide s'il n'a pas été relevé. La consommation de ce jour-là est l'écart entre le relevé précédent et changedValue, et vaut 0 sans lui. Ces deux champs se lisent et ne s'écrivent pas, un changement de compteur se déclare dans l'écran. Une modification ne change que la valeur. Les relevés d'un compteur inactif ne se créent, ne se modifient et ne se suppriment plus, ce que dit un code 412.
- [Relevés de pluie](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/releves-de-pluie.md): Le total de pluie d'un jour sur un pluviomètre, en mm. Il n'y a qu'un relevé par pluviomètre et par jour. Créer un relevé ajoute au jour au lieu de le remplacer, comme une seconde saisie dans l'écran : envoyer deux fois 12 mm sur la même date laisse 24 mm. Pour fixer un total, modifiez le relevé du jour. Une quantité négative retire des mm à un jour qui en porte déjà autant, et le jour ramené à zéro perd son relevé. La création rend le jour tel qu'il est après l'ajout, avec son total, et non la seule quantité envoyée : elle répond 200, et un jour vidé rend un total de 0 sans identifiant.
- [Usages du catalogue E-Phy](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/boite-a-outils/usages-du-catalogue-e-phy.md): Ce qu'un produit du catalogue E-Phy est autorisé à traiter : la culture, la cible, la dose et le délai avant récolte. Le catalogue publie une ligne par cible, par mode de traitement et par délai, si bien qu'un même produit sur une même culture en porte souvent plusieurs.
- [Espèces et variétés](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes.md): Ce que vous cultivez : vos espèces et leurs variétés, les calibres et les tags qui les décrivent, et les récoltes attendues saison par saison.
- [Calibres](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes/calibres.md): Les calibres définis pour vos espèces (ex. petit / moyen / gros), utilisés notamment pour distinguer les rendements par calibre.
- [Espèces](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes/especes.md): Les espèces cultivées par votre structure.
- [Familles botaniques](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes/familles-botaniques.md): Le référentiel des familles botaniques, commun à toutes les structures et consultable uniquement. Les ids servent à renseigner la famille d'une espèce.
- [Prévisionnels de récolte](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes/previsionnels-de-recolte.md): Les prévisionnels de récolte par espèce et par saison (quantité attendue, répartition professionnel / autoconsommation).
- [Tags de variétés](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes/tags-de-varietes.md): Le vocabulaire commun par lequel on décrit une variété (couleur, forme, usage…), partagé par toutes les structures et consultable uniquement. Le filtre plant donne les tags qu'une espèce accepte.
- [Variétés](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/especes-et-varietes/varietes.md): Les variétés cultivées pour chacune de vos espèces, avec leurs fournisseurs de semences et de plants.
- [Itinéraires techniques](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/itineraires-techniques.md): Vos modèles de culture : les espèces menées ensemble, leur conduite, et les interventions à mener sur chacune. Une série du plan de culture se déroule à partir d'un itinéraire.
- [Espèces d'un itinéraire](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/itineraires-techniques/especes-dun-itineraire.md): Une espèce dans un itinéraire technique, avec sa conduite (écartements ou densité, semis, rendement attendu) et la répartition des variétés qu'on y met. Une même espèce n'y figure qu'une fois.
- [Interventions d'un itinéraire](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/itineraires-techniques/interventions-dun-itineraire.md): Une intervention modèle, datée en semaines relatives plutôt qu'en dates : c'est ce que le plan de culture déroule en interventions le jour où une série naît de l'itinéraire. Elle porte sur une espèce, ou sur tout l'itinéraire.
- [Itinéraires](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/itineraires-techniques/itineraires.md): Un modèle de culture, annuel ou pérenne, dont on déroule des séries. Les espèces qu'il réunit s'envoient à sa création et ne se changent plus ensuite.
- [Plan de culture](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture.md): Votre plan de culture pour la saison : les séries, ce qui y est mis en culture, et les interventions planifiées avec leurs commentaires.
- [Commentaires d'interventions](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/commentaires-dinterventions.md): Les commentaires laissés sur une intervention du planning. Chaque commentaire est rattaché à une intervention, et hérite d'elle sa série et sa mise en culture.
- [Emplacements](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/emplacements.md): L'occupation des planches : une ligne par planche et par série, avec le linéaire et la surface qu'elle y occupe. Une intervention posée hors série y figure aussi, sans dimensions. L'assolement se modifie par les actions de la ressource série.
- [Interventions](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/interventions.md): Les interventions planifiées dans le planning. Chaque intervention est une occurrence d'une action (semis, désherbage, récolte...), liée à une culture et éventuellement à une série.
- [Mises en culture](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/mises-en-culture.md): La culture d'une variété au sein d'une série, sur une saison donnée (surface, densité, dates, itinéraire technique).
- [Récoltes](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/recoltes.md): Ce qui a été récolté, jour par jour : une ligne par intervention de récolte et par date, avec sa quantité et son unité. Les récoltes se saisissent sur l'intervention, qui met à jour les cumuls de la mise en culture : elles sont ici en lecture seule. La période est obligatoire.
- [Séries](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/series.md): Les séries de votre plan de culture : un regroupement de cultures menées ensemble, sur les mêmes emplacements (planches), pour une saison donnée.
- [Temps de travail](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-culture/temps-de-travail.md): Le temps passé sur une intervention : une ligne par intervention, par personne et par date. L'intervention se désigne à la création et donne à la ligne sa série, sa mise en culture et son espèce. Seule la durée se modifie ensuite. La période est obligatoire.
- [Plan de la ferme](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-la-ferme.md): Le plan de votre ferme, du plus large au plus fin : les parcelles, les jardins qui les découpent et les planches de culture.
- [Jardins](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-la-ferme/jardins.md): Les jardins d'une parcelle, en plein champ ou couverts par un abri. Un jardin couvert porte les dimensions de son abri, dont se déduit sa surface. Dessiné dans une parcelle elle-même dessinée, il tire ses dimensions de son polygone, qui se modifie seul et les entraîne, et celles qu'on lui envoie sont remplacées. Effacer ce polygone demande d'envoyer aussi les dimensions de l'abri. Un nouveau polygone trop étroit pour un abri est refusé. Un jardin en plein champ dessiné a la surface de son polygone, qui se modifie donc avec lui. Le jardin qui porte les planches posées à même la parcelle se lit, mais ne se modifie ni ne se supprime : il suit sa parcelle. Un jardin ne change pas de parcelle : celle-ci se pose à la création. Couvrir ou découvrir un jardin ne se fait pas par l'API.
- [Parcelles](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-la-ferme/parcelles.md): Les parcelles qui composent le plan, chacune délimitée par un polygone et découpée en jardins. Une parcelle dessinée a la surface de son polygone, qui se modifie donc avec lui.
- [Planches](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/plan-de-la-ferme/planches.md): Les planches de culture d'un jardin, avec leurs dimensions. Les planches de remplissage, créées par le produit pour porter une culture posée sur un jardin entier, n'apparaissent pas ici.
- [Pense-bête](https://ouvretaferme.gitbook.io/ouvretaferme/endpoints/production/pense-bete.md): Les rappels du pense-bête : une ligne de texte rattachée à une semaine, avec un jour en option, qu'on coche une fois faite. Un rappel ne se crée pas dans une semaine passée. Un rappel coché dans une semaine passée ne se corrige plus et ne s'efface plus. La liste rend chaque rappel dans sa semaine, sans le recopier dans les semaines où il reste à faire.