> For the complete documentation index, see [llms.txt](https://docs.abby.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abby.fr/reference-de-lapi/produits.md).

# Catalogue

Gérez le catalogue de produits et de services que vous facturez.

Le catalogue regroupe les produits et services que vous facturez souvent : désignation, type, unité, prix et code de TVA. Créez un produit une fois, puis réutilisez-le sur vos documents.

{% hint style="info" %}
L'API publique n'expose aucune route de suppression de produit. On peut créer, lire, lister et modifier.
{% endhint %}

## Comprendre les champs d'un produit

* **Les prix sont en centimes** : `amountInCents` et `purchasePrice` sont des entiers (`1999` vaut 19,99). Voir [Conventions](https://docs.abby.fr/concepts/conventions.md).
* **`type`** prend l'une des valeurs de `ProductType` : `sale_of_goods`, `service_delivery`, `commercial_or_craft_services`, `sale_of_manufactured_goods`, `disbursement`.
* **`unit`** prend l'une des valeurs de `ProductUnit` : `unit`, `gram`, `hour`, `day`, `week`, `fixed_rate`, `year`, `character`, `line`, `license`, `article`, `month`, `kilogram`, `kilometer`, `liter`, `batch`, `meter`, `square_meter`, `cubic_meter`, `linear_meter`, `person`, `ton`, `word`, `page`, `leaflet`, `paragraph`, `minute`, `overnight_stay`.
* **`vatCode`** prend l'une des valeurs de `VatCode` : `FR_210`, `FR_550`, `FR_850`, `FR_1000`, `FR_2000`, `FR_00HT`, `FR_00UE`, `FR_0HUE`. La valeur par défaut déclarée à la création est `FR_00HT`.
* **`taxesIncluded`** indique si le montant saisi inclut la TVA.
* **`lockUnitPrice`** indique si le prix unitaire est figé, au lieu d'être calculé à partir du prix d'achat (`purchasePrice`) et de la marge (`productMargin`, en pourcentage).

## Lister les produits

La liste est paginée sous forme d'enveloppe : le tableau `docs` contient les produits, accompagné de `totalDocs`, `page`, `limit`, `totalPages`, `hasNextPage`, etc. Voir [Pagination](https://docs.abby.fr/concepts/pagination.md).

Paramètres de requête :

| Paramètre        | Obligatoire | Rôle                                                                                                                                                           |
| ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page`           | oui         | Numéro de page, à partir de `1`.                                                                                                                               |
| `limit`          | oui         | Nombre d'éléments par page.                                                                                                                                    |
| `search`         | non         | Terme cherché dans `designation` et `reference`.                                                                                                               |
| `orderBy`        | non         | `createdAt` ou `designation`.                                                                                                                                  |
| `orderDirection` | non         | `ASC` ou `DESC`.                                                                                                                                               |
| `sapCompatible`  | non         | `true` : seulement les produits qui portent une activité de services à la personne (`personalServiceActivity`). `false` : seulement ceux qui n'en portent pas. |

```bash
curl "https://api.abby.fr/v2/catalog?page=1&limit=20&orderBy=designation&orderDirection=ASC" \
  -H "Authorization: Bearer $ABBY_API_KEY"
```

## GET /v2/catalog

> List products with pagination

```json
{"openapi":"3.0.0","info":{"title":"Abby Public API","version":"1.130.0+66756885474b"},"servers":[{"url":"https://api.abby.fr","description":"Production server"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Pass your API key as a Bearer token."}},"schemas":{"CatalogOrderBy":{"type":"string","enum":["createdAt","designation"]},"OrderDirection":{"type":"string","enum":["ASC","DESC"]},"ReadCatalogCollectionDto":{"type":"object","properties":{"countWithoutFilters":{"type":"number"},"totalDocs":{"type":"number"},"limit":{"type":"number"},"totalPages":{"type":"number"},"hasNextPage":{"type":"boolean"},"hasPrevPage":{"type":"boolean"},"nextPage":{"type":"number"},"page":{"type":"number"},"prevPage":{"type":"number"},"docs":{"type":"array","items":{"$ref":"#/components/schemas/ReadProductListItemDto"}}},"required":["countWithoutFilters","totalDocs","limit","totalPages","hasNextPage","hasPrevPage","nextPage","page","prevPage","docs"]},"ReadProductListItemDto":{"type":"object","properties":{"id":{"type":"string"},"type":{"allOf":[{"$ref":"#/components/schemas/ProductType"}]},"unit":{"allOf":[{"$ref":"#/components/schemas/ProductUnit"}]},"designation":{"type":"string"},"description":{"type":"string","nullable":true},"reference":{"type":"string","nullable":true},"vatCode":{"allOf":[{"$ref":"#/components/schemas/VatCode"}]},"personalServiceActivity":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/PersonalServiceActivity"}]},"isDeliveryOfGood":{"type":"boolean"},"taxesIncluded":{"type":"boolean"},"purchasePrice":{"type":"number","description":"Purchase price per unit without taxes"},"productMargin":{"type":"number","description":"Product margin"},"unitPrice":{"type":"number","description":"Price per unit without taxes"},"priceWithoutTaxes":{"type":"number","description":"Total price without taxes"},"vatAmount":{"type":"number","description":"VAT amount"},"priceWithTaxes":{"type":"number","description":"Total price including taxes"},"stock":{"type":"number","description":"Stock"}},"required":["id","type","unit","designation","vatCode","isDeliveryOfGood","taxesIncluded","unitPrice","priceWithoutTaxes","vatAmount","priceWithTaxes","stock"]},"ProductType":{"type":"string","enum":["sale_of_goods","service_delivery","commercial_or_craft_services","sale_of_manufactured_goods","disbursement"]},"ProductUnit":{"type":"string","enum":["unit","gram","hour","day","week","fixed_rate","year","character","line","license","article","month","kilogram","kilometer","liter","batch","meter","square_meter","cubic_meter","linear_meter","person","ton","word","page","leaflet","paragraph","minute","overnight_stay"]},"VatCode":{"type":"string","enum":["FR_210","FR_550","FR_850","FR_1000","FR_2000","FR_00HT","FR_00UE","FR_0HUE"]},"PersonalServiceActivity":{"type":"string","enum":["GARDE_ENFANT_HANDICAPE","ACCOMPAGNEMENT_ENFANT_HANDICAPE","AIDE_HUMAINE","CONDUITE_VEHICULE_PERSONNEL","AIDE_AU_DEPLACEMENT","ENTRETIEN_DE_LA_MAISON","JARDINAGE","BRICOLAGE","GARDE_ENFANT_PLUS_DE_6_ANS","SOUTIEN_SCOLAIRE_COURS_A_DOMICILE","SOIN_ESTHETIQUE_A_DOMICILE","PREPARATION_REPAS_A_DOMICILE","LIVRAISON_REPAS_A_DOMICILE","COLLECTE_ET_LIVRAISON_DE_LINGE_REPASSE","LIVRAISON_COURSES_A_DOMICILE","ASSISTANCE_INFORMATIQUE","SOINS_ET_PROMENADES_ANIMAUX_DE_COMPAGNIE_POUR_PERSONNES_DEPENDANTES","MAINTENANCE_ENTRETIEN_ET_VIGILANCE_DE_LA_RESIDENCE_PRINCIPALE","ASSISTANCE_ADMINISTRATIVE","ACCOMPAGNEMENT_ENFANT_PLUS_DE_6_ANS","TELEASSISTANCE","INTERPRETE_LANGUE_DES_SIGNES","CONDUITE_VEHICULE_PERSONNEL_EN_CAS_INVALIDITE_TEMPORAIRE","ACCOMPAGNEMENT_DEPLACEMENTS_EN_DEHORS_DU_DOMICILE","ASSISTANCE_PERSONNES_TEMPORAIREMENT_DEPENDANTES_A_DOMICILE","COORDINATION_ET_GESTION","DIVERS_NON_ELIGIBLE"]}}},"paths":{"/v2/catalog":{"get":{"operationId":"CatalogController_paginate_v2","parameters":[{"name":"page","required":true,"in":"query","description":"The page number to retrieve","schema":{"minimum":1,"type":"number"}},{"name":"limit","required":true,"in":"query","description":"The number of items per page","schema":{"minimum":1,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Optional search term to filter the catalog","schema":{"type":"string"}},{"name":"orderBy","required":false,"in":"query","description":"Optional order by to filter the catalog","schema":{"$ref":"#/components/schemas/CatalogOrderBy"}},{"name":"orderDirection","required":false,"in":"query","description":"Optional order direction to filter the catalog","schema":{"$ref":"#/components/schemas/OrderDirection"}},{"name":"sapCompatible","required":false,"in":"query","description":"Optional sap compatible to filter the catalog","schema":{"type":"boolean"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadCatalogCollectionDto"}}}}},"summary":"List products with pagination","tags":["catalog"]}}}}
```

## Lire un produit

Renvoie le produit avec ses prix calculés : `unitPrice`, `priceWithoutTaxes`, `vatAmount` et `priceWithTaxes`.

```bash
curl https://api.abby.fr/v2/catalog/product/$PRODUCT_ID \
  -H "Authorization: Bearer $ABBY_API_KEY"
```

## GET /v2/catalog/product/{productId}

> Retrieve a product by id

```json
{"openapi":"3.0.0","info":{"title":"Abby Public API","version":"1.130.0+66756885474b"},"servers":[{"url":"https://api.abby.fr","description":"Production server"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Pass your API key as a Bearer token."}},"schemas":{"ReadProductDto":{"type":"object","properties":{"id":{"type":"string"},"type":{"description":"Type of the product","allOf":[{"$ref":"#/components/schemas/ProductType"}]},"unit":{"description":"Unit of measurement for the product","allOf":[{"$ref":"#/components/schemas/ProductUnit"}]},"designation":{"type":"string","description":"Name or title of the product"},"description":{"type":"string","nullable":true,"description":"Detailed description of the product"},"reference":{"type":"string","nullable":true,"description":"Product reference code"},"vatCode":{"description":"VAT code applicable to this product","allOf":[{"$ref":"#/components/schemas/VatCode"}]},"personalServiceActivity":{"nullable":true,"description":"Personal service activity classification, if applicable","allOf":[{"$ref":"#/components/schemas/PersonalServiceActivity"}]},"isDeliveryOfGood":{"type":"boolean","description":"Indicates if the product involves delivery of physical goods"},"taxesIncluded":{"type":"boolean","description":"Indicates if the prices include taxes"},"purchasePrice":{"type":"number","description":"Purchase price per unit without taxes"},"productMargin":{"type":"number","description":"Product margin"},"lockUnitPrice":{"type":"boolean","description":"Indicates if the unit price is locked"},"unitPrice":{"type":"number","description":"Price per unit without taxes"},"priceWithoutTaxes":{"type":"number","description":"Total price without taxes"},"vatAmount":{"type":"number","description":"VAT amount"},"priceWithTaxes":{"type":"number","description":"Total price including taxes"},"stock":{"type":"number","description":"Stock"}},"required":["id","type","unit","designation","vatCode","isDeliveryOfGood","taxesIncluded","unitPrice","priceWithoutTaxes","vatAmount","priceWithTaxes","stock"]},"ProductType":{"type":"string","enum":["sale_of_goods","service_delivery","commercial_or_craft_services","sale_of_manufactured_goods","disbursement"]},"ProductUnit":{"type":"string","enum":["unit","gram","hour","day","week","fixed_rate","year","character","line","license","article","month","kilogram","kilometer","liter","batch","meter","square_meter","cubic_meter","linear_meter","person","ton","word","page","leaflet","paragraph","minute","overnight_stay"]},"VatCode":{"type":"string","enum":["FR_210","FR_550","FR_850","FR_1000","FR_2000","FR_00HT","FR_00UE","FR_0HUE"]},"PersonalServiceActivity":{"type":"string","enum":["GARDE_ENFANT_HANDICAPE","ACCOMPAGNEMENT_ENFANT_HANDICAPE","AIDE_HUMAINE","CONDUITE_VEHICULE_PERSONNEL","AIDE_AU_DEPLACEMENT","ENTRETIEN_DE_LA_MAISON","JARDINAGE","BRICOLAGE","GARDE_ENFANT_PLUS_DE_6_ANS","SOUTIEN_SCOLAIRE_COURS_A_DOMICILE","SOIN_ESTHETIQUE_A_DOMICILE","PREPARATION_REPAS_A_DOMICILE","LIVRAISON_REPAS_A_DOMICILE","COLLECTE_ET_LIVRAISON_DE_LINGE_REPASSE","LIVRAISON_COURSES_A_DOMICILE","ASSISTANCE_INFORMATIQUE","SOINS_ET_PROMENADES_ANIMAUX_DE_COMPAGNIE_POUR_PERSONNES_DEPENDANTES","MAINTENANCE_ENTRETIEN_ET_VIGILANCE_DE_LA_RESIDENCE_PRINCIPALE","ASSISTANCE_ADMINISTRATIVE","ACCOMPAGNEMENT_ENFANT_PLUS_DE_6_ANS","TELEASSISTANCE","INTERPRETE_LANGUE_DES_SIGNES","CONDUITE_VEHICULE_PERSONNEL_EN_CAS_INVALIDITE_TEMPORAIRE","ACCOMPAGNEMENT_DEPLACEMENTS_EN_DEHORS_DU_DOMICILE","ASSISTANCE_PERSONNES_TEMPORAIREMENT_DEPENDANTES_A_DOMICILE","COORDINATION_ET_GESTION","DIVERS_NON_ELIGIBLE"]}}},"paths":{"/v2/catalog/product/{productId}":{"get":{"operationId":"CatalogController_retrieve_v2","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadProductDto"}}}}},"summary":"Retrieve a product by id","tags":["catalog"]}}}}
```

## Créer un produit

`type`, `unit` et `designation` sont obligatoires. Gardez l'`id` renvoyé pour le retrouver ensuite.

```bash
curl -X POST https://api.abby.fr/v2/catalog/product \
  -H "Authorization: Bearer $ABBY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "service_delivery",
    "unit": "hour",
    "designation": "Conseil en gestion",
    "amountInCents": 9000,
    "taxesIncluded": false,
    "vatCode": "FR_2000",
    "reference": "CONSEIL-001",
    "description": "Heure de conseil"
  }'
```

## POST /v2/catalog/product

> Create a new product

```json
{"openapi":"3.0.0","info":{"title":"Abby Public API","version":"1.130.0+66756885474b"},"servers":[{"url":"https://api.abby.fr","description":"Production server"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Pass your API key as a Bearer token."}},"schemas":{"CreateProductDto":{"type":"object","properties":{"type":{"description":"The type of the product","allOf":[{"$ref":"#/components/schemas/ProductType"}]},"unit":{"description":"The unit of measurement for the product","allOf":[{"$ref":"#/components/schemas/ProductUnit"}]},"designation":{"type":"string","description":"The name or title of the product"},"amountInCents":{"type":"number","description":"The price of the product in cents"},"purchasePrice":{"type":"number","description":"The purchase price of the product in cents"},"productMargin":{"type":"number","description":"The margin of the product in percentage"},"lockUnitPrice":{"type":"boolean","description":"Whether the unit price is locked or not calculating from purchase price and product margin","default":false},"taxesIncluded":{"type":"boolean","description":"Whether the amount includes taxes"},"vatCode":{"description":"The VAT code applicable to the product","default":"FR_00HT","allOf":[{"$ref":"#/components/schemas/VatCode"}]},"isDeliveryOfGood":{"type":"boolean","description":"Whether the product involves delivery of a physical good"},"description":{"type":"string","description":"Detailed description of the product"},"reference":{"type":"string","description":"Product reference or SKU"},"stock":{"type":"number","description":"The stock quantity"}},"required":["type","unit","designation"]},"ProductType":{"type":"string","enum":["sale_of_goods","service_delivery","commercial_or_craft_services","sale_of_manufactured_goods","disbursement"]},"ProductUnit":{"type":"string","enum":["unit","gram","hour","day","week","fixed_rate","year","character","line","license","article","month","kilogram","kilometer","liter","batch","meter","square_meter","cubic_meter","linear_meter","person","ton","word","page","leaflet","paragraph","minute","overnight_stay"]},"VatCode":{"type":"string","enum":["FR_210","FR_550","FR_850","FR_1000","FR_2000","FR_00HT","FR_00UE","FR_0HUE"]},"ReadProductDto":{"type":"object","properties":{"id":{"type":"string"},"type":{"description":"Type of the product","allOf":[{"$ref":"#/components/schemas/ProductType"}]},"unit":{"description":"Unit of measurement for the product","allOf":[{"$ref":"#/components/schemas/ProductUnit"}]},"designation":{"type":"string","description":"Name or title of the product"},"description":{"type":"string","nullable":true,"description":"Detailed description of the product"},"reference":{"type":"string","nullable":true,"description":"Product reference code"},"vatCode":{"description":"VAT code applicable to this product","allOf":[{"$ref":"#/components/schemas/VatCode"}]},"personalServiceActivity":{"nullable":true,"description":"Personal service activity classification, if applicable","allOf":[{"$ref":"#/components/schemas/PersonalServiceActivity"}]},"isDeliveryOfGood":{"type":"boolean","description":"Indicates if the product involves delivery of physical goods"},"taxesIncluded":{"type":"boolean","description":"Indicates if the prices include taxes"},"purchasePrice":{"type":"number","description":"Purchase price per unit without taxes"},"productMargin":{"type":"number","description":"Product margin"},"lockUnitPrice":{"type":"boolean","description":"Indicates if the unit price is locked"},"unitPrice":{"type":"number","description":"Price per unit without taxes"},"priceWithoutTaxes":{"type":"number","description":"Total price without taxes"},"vatAmount":{"type":"number","description":"VAT amount"},"priceWithTaxes":{"type":"number","description":"Total price including taxes"},"stock":{"type":"number","description":"Stock"}},"required":["id","type","unit","designation","vatCode","isDeliveryOfGood","taxesIncluded","unitPrice","priceWithoutTaxes","vatAmount","priceWithTaxes","stock"]},"PersonalServiceActivity":{"type":"string","enum":["GARDE_ENFANT_HANDICAPE","ACCOMPAGNEMENT_ENFANT_HANDICAPE","AIDE_HUMAINE","CONDUITE_VEHICULE_PERSONNEL","AIDE_AU_DEPLACEMENT","ENTRETIEN_DE_LA_MAISON","JARDINAGE","BRICOLAGE","GARDE_ENFANT_PLUS_DE_6_ANS","SOUTIEN_SCOLAIRE_COURS_A_DOMICILE","SOIN_ESTHETIQUE_A_DOMICILE","PREPARATION_REPAS_A_DOMICILE","LIVRAISON_REPAS_A_DOMICILE","COLLECTE_ET_LIVRAISON_DE_LINGE_REPASSE","LIVRAISON_COURSES_A_DOMICILE","ASSISTANCE_INFORMATIQUE","SOINS_ET_PROMENADES_ANIMAUX_DE_COMPAGNIE_POUR_PERSONNES_DEPENDANTES","MAINTENANCE_ENTRETIEN_ET_VIGILANCE_DE_LA_RESIDENCE_PRINCIPALE","ASSISTANCE_ADMINISTRATIVE","ACCOMPAGNEMENT_ENFANT_PLUS_DE_6_ANS","TELEASSISTANCE","INTERPRETE_LANGUE_DES_SIGNES","CONDUITE_VEHICULE_PERSONNEL_EN_CAS_INVALIDITE_TEMPORAIRE","ACCOMPAGNEMENT_DEPLACEMENTS_EN_DEHORS_DU_DOMICILE","ASSISTANCE_PERSONNES_TEMPORAIREMENT_DEPENDANTES_A_DOMICILE","COORDINATION_ET_GESTION","DIVERS_NON_ELIGIBLE"]}}},"paths":{"/v2/catalog/product":{"post":{"operationId":"CatalogController_create_v2","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadProductDto"}}}}},"summary":"Create a new product","tags":["catalog"]}}}}
```

## Modifier un produit

`PUT` attend la fiche complète : `type`, `unit`, `designation` et `vatCode` sont obligatoires, même si vous ne changez que le prix. Les prix sont recalculés à partir du corps envoyé : `taxesIncluded` et `lockUnitPrice` absents valent `false`. Renvoyez donc aussi les valeurs que vous voulez conserver.

```bash
curl -X PUT https://api.abby.fr/v2/catalog/product/$PRODUCT_ID \
  -H "Authorization: Bearer $ABBY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "service_delivery",
    "unit": "hour",
    "designation": "Conseil en gestion",
    "vatCode": "FR_2000",
    "amountInCents": 9500
  }'
```

## PUT /v2/catalog/product/{productId}

> Update a product

```json
{"openapi":"3.0.0","info":{"title":"Abby Public API","version":"1.130.0+66756885474b"},"servers":[{"url":"https://api.abby.fr","description":"Production server"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Pass your API key as a Bearer token."}},"schemas":{"UpdateProductDto":{"type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/ProductType"}]},"unit":{"allOf":[{"$ref":"#/components/schemas/ProductUnit"}]},"designation":{"type":"string"},"amountInCents":{"type":"number","description":"The price of the product in cents"},"purchasePrice":{"type":"number","description":"The purchase price of the product in cents"},"productMargin":{"type":"number","description":"The margin of the product in percentage"},"lockUnitPrice":{"type":"boolean","description":"Whether the unit price is locked or not calculating from purchase price and product margin","default":false},"taxesIncluded":{"type":"boolean"},"vatCode":{"allOf":[{"$ref":"#/components/schemas/VatCode"}]},"isDeliveryOfGood":{"type":"boolean"},"description":{"type":"string"},"reference":{"type":"string"},"stock":{"type":"number"}},"required":["type","unit","designation","vatCode"]},"ProductType":{"type":"string","enum":["sale_of_goods","service_delivery","commercial_or_craft_services","sale_of_manufactured_goods","disbursement"]},"ProductUnit":{"type":"string","enum":["unit","gram","hour","day","week","fixed_rate","year","character","line","license","article","month","kilogram","kilometer","liter","batch","meter","square_meter","cubic_meter","linear_meter","person","ton","word","page","leaflet","paragraph","minute","overnight_stay"]},"VatCode":{"type":"string","enum":["FR_210","FR_550","FR_850","FR_1000","FR_2000","FR_00HT","FR_00UE","FR_0HUE"]},"ReadProductDto":{"type":"object","properties":{"id":{"type":"string"},"type":{"description":"Type of the product","allOf":[{"$ref":"#/components/schemas/ProductType"}]},"unit":{"description":"Unit of measurement for the product","allOf":[{"$ref":"#/components/schemas/ProductUnit"}]},"designation":{"type":"string","description":"Name or title of the product"},"description":{"type":"string","nullable":true,"description":"Detailed description of the product"},"reference":{"type":"string","nullable":true,"description":"Product reference code"},"vatCode":{"description":"VAT code applicable to this product","allOf":[{"$ref":"#/components/schemas/VatCode"}]},"personalServiceActivity":{"nullable":true,"description":"Personal service activity classification, if applicable","allOf":[{"$ref":"#/components/schemas/PersonalServiceActivity"}]},"isDeliveryOfGood":{"type":"boolean","description":"Indicates if the product involves delivery of physical goods"},"taxesIncluded":{"type":"boolean","description":"Indicates if the prices include taxes"},"purchasePrice":{"type":"number","description":"Purchase price per unit without taxes"},"productMargin":{"type":"number","description":"Product margin"},"lockUnitPrice":{"type":"boolean","description":"Indicates if the unit price is locked"},"unitPrice":{"type":"number","description":"Price per unit without taxes"},"priceWithoutTaxes":{"type":"number","description":"Total price without taxes"},"vatAmount":{"type":"number","description":"VAT amount"},"priceWithTaxes":{"type":"number","description":"Total price including taxes"},"stock":{"type":"number","description":"Stock"}},"required":["id","type","unit","designation","vatCode","isDeliveryOfGood","taxesIncluded","unitPrice","priceWithoutTaxes","vatAmount","priceWithTaxes","stock"]},"PersonalServiceActivity":{"type":"string","enum":["GARDE_ENFANT_HANDICAPE","ACCOMPAGNEMENT_ENFANT_HANDICAPE","AIDE_HUMAINE","CONDUITE_VEHICULE_PERSONNEL","AIDE_AU_DEPLACEMENT","ENTRETIEN_DE_LA_MAISON","JARDINAGE","BRICOLAGE","GARDE_ENFANT_PLUS_DE_6_ANS","SOUTIEN_SCOLAIRE_COURS_A_DOMICILE","SOIN_ESTHETIQUE_A_DOMICILE","PREPARATION_REPAS_A_DOMICILE","LIVRAISON_REPAS_A_DOMICILE","COLLECTE_ET_LIVRAISON_DE_LINGE_REPASSE","LIVRAISON_COURSES_A_DOMICILE","ASSISTANCE_INFORMATIQUE","SOINS_ET_PROMENADES_ANIMAUX_DE_COMPAGNIE_POUR_PERSONNES_DEPENDANTES","MAINTENANCE_ENTRETIEN_ET_VIGILANCE_DE_LA_RESIDENCE_PRINCIPALE","ASSISTANCE_ADMINISTRATIVE","ACCOMPAGNEMENT_ENFANT_PLUS_DE_6_ANS","TELEASSISTANCE","INTERPRETE_LANGUE_DES_SIGNES","CONDUITE_VEHICULE_PERSONNEL_EN_CAS_INVALIDITE_TEMPORAIRE","ACCOMPAGNEMENT_DEPLACEMENTS_EN_DEHORS_DU_DOMICILE","ASSISTANCE_PERSONNES_TEMPORAIREMENT_DEPENDANTES_A_DOMICILE","COORDINATION_ET_GESTION","DIVERS_NON_ELIGIBLE"]}}},"paths":{"/v2/catalog/product/{productId}":{"put":{"operationId":"CatalogController_update_v2","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadProductDto"}}}}},"summary":"Update a product","tags":["catalog"]}}}}
```

## Utiliser un produit sur un document

Les lignes d'un document (`PATCH /v2/billing/{billingId}/lines`) acceptent un champ facultatif `productId`, qui référence l'identifiant d'un produit. Les lignes restent complètes par elles-mêmes : `designation`, `quantity`, `quantityUnit`, `unitPrice` et `type` sont obligatoires sur chaque ligne, et `vatCode` peut y être précisé. Voir [Documents de facturation](https://docs.abby.fr/reference-de-lapi/documents-de-facturation.md).

## Voir aussi

* [Conventions](https://docs.abby.fr/concepts/conventions.md)
* [Pagination](https://docs.abby.fr/concepts/pagination.md)
* [Documents de facturation](https://docs.abby.fr/reference-de-lapi/documents-de-facturation.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.abby.fr/reference-de-lapi/produits.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
