POST /quote/{uid}/line

Ajoute une nouvelle ligne à un devis existant.

Les totaux sont automatiquement recalculés après l'ajout.

Path parameters

  • uid string Required

    ID du devis

application/json

Body Required

  • _id string

    Unique identifier for the line

  • description string

    Description of the line

  • price_ht number

    Price without tax

    Default value is 0.

  • quantity number

    Quantity

    Default value is 1.

  • reference string

    Reference of the product

  • title string

    Title of the line

  • total_ht number

    Total amount without tax

    Default value is 0.

  • total_ttc number

    Total amount with tax

    Default value is 0.

  • tva_rate number

    VAT rate

  • type string

    Type of the line

    Values are product, header, subtotal, or globalDiscount. Default value is product.

  • unit string

    Unit of measurement

Responses

  • 200 application/json

    Ligne ajoutée

    Hide response attributes Show response attributes object
    • updatedQuote object
      Hide updatedQuote attributes Show updatedQuote attributes object
      • _id string

        Unique identifier for the quote

      • VATRates array[object]

        List of VAT rates applied to the quote

        Hide VATRates attributes Show VATRates attributes object
        • amount number

          Amount of VAT

        • rate string

          VAT rate

        • total number

          Total amount with this VAT rate

      • accept_date string(date-time)

        Date when the quote was accepted

      • acomptes array[object]

        List of advance payments

        Hide acomptes attributes Show acomptes attributes object
        • _id string
        • amount number

          Amount of the advance payment

        • amount_ht number

          Amount without tax

        • credit boolean

          If it's a credit note

          Default value is false.

        • date string(date-time)
        • sold boolean

          Default value is false.

        • number string
        • type string

          Type of payment

          Values are advance, sold, credit, or invoice.

      • base_currency string

        The currency with which the company works for this quote

        Default value is EUR.

      • client string

        Reference to the client

      • client_name string

        Name of the client

      • client_address string

        Address of the client

      • client_city string

        City of the client

      • client_zip_code string

        Zip code of the client

      • client_country string

        Country of the client

        Default value is France.

      • client_email string

        Email of the client

      • client_phone string

        Phone number of the client

      • company string

        Reference to the company

      • company_name string

        Name of the company

      • date string(date-time)

        Date of the quote

      • expiry_date string(date-time)

        Expiry date of the quote

      • quote_lines array[object]

        List of quote lines

        Hide quote_lines attributes Show quote_lines attributes object
        • _id string

          Unique identifier for the line

        • description string

          Description of the line

        • price_ht number

          Price without tax

          Default value is 0.

        • quantity number

          Quantity

          Default value is 1.

        • reference string

          Reference of the product

        • title string

          Title of the line

        • total_ht number

          Total amount without tax

          Default value is 0.

        • total_ttc number

          Total amount with tax

          Default value is 0.

        • tva_rate number

          VAT rate

        • type string

          Type of the line

          Values are product, header, subtotal, or globalDiscount. Default value is product.

        • unit string

          Unit of measurement

      • number string

        Quote number

      • state string

        State of the quote

        Values are invoiced, refused, accepted, waiting, draft, canceled, or inactive. Default value is waiting.

      • title string

        Short description or label of the quote

      • total_ht number

        Total amount without tax

      • total_ttc number

        Total amount with tax

      • total_tva number

        Total tax amount

      • type string

        Type of the quote

        Values are quote, proforma, or bdc. Default value is quote.

    • line object
      Hide line attributes Show line attributes object
      • _id string

        Unique identifier for the line

      • description string

        Description of the line

      • price_ht number

        Price without tax

        Default value is 0.

      • quantity number

        Quantity

        Default value is 1.

      • reference string

        Reference of the product

      • title string

        Title of the line

      • total_ht number

        Total amount without tax

        Default value is 0.

      • total_ttc number

        Total amount with tax

        Default value is 0.

      • tva_rate number

        VAT rate

      • type string

        Type of the line

        Values are product, header, subtotal, or globalDiscount. Default value is product.

      • unit string

        Unit of measurement

  • 400

    Bad request - Invalid input

  • 403

    Forbidden - Not authorized to modify this quote

  • 404

    Quote not found

POST /quote/{uid}/line
curl \
 --request POST 'https://wuro.pro/api/v3.2/quote/{uid}/line' \
 --header "X-APP-ID: $API_KEY" \
 --header "X-APP-SECRET: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"_id":"string","description":"string","price_ht":0,"quantity":1,"reference":"string","title":"string","total_ht":0,"total_ttc":0,"tva_rate":42.0,"type":"product","unit":"string"}'
Request examples
{
  "_id": "string",
  "description": "string",
  "price_ht": 0,
  "quantity": 1,
  "reference": "string",
  "title": "string",
  "total_ht": 0,
  "total_ttc": 0,
  "tva_rate": 42.0,
  "type": "product",
  "unit": "string"
}
Response examples (200)
{
  "updatedQuote": {
    "_id": "string",
    "VATRates": [
      {
        "amount": 42.0,
        "rate": "string",
        "total": 42.0
      }
    ],
    "accept_date": "2025-05-04T09:42:00Z",
    "acomptes": [
      {
        "_id": "string",
        "amount": 42.0,
        "amount_ht": 42.0,
        "credit": false,
        "date": "2025-05-04T09:42:00Z",
        "sold": false,
        "number": "string",
        "type": "advance"
      }
    ],
    "base_currency": "EUR",
    "client": "string",
    "client_name": "string",
    "client_address": "string",
    "client_city": "string",
    "client_zip_code": "string",
    "client_country": "France",
    "client_email": "string",
    "client_phone": "string",
    "company": "string",
    "company_name": "string",
    "date": "2025-05-04T09:42:00Z",
    "expiry_date": "2025-05-04T09:42:00Z",
    "quote_lines": [
      {
        "_id": "string",
        "description": "string",
        "price_ht": 0,
        "quantity": 1,
        "reference": "string",
        "title": "string",
        "total_ht": 0,
        "total_ttc": 0,
        "tva_rate": 42.0,
        "type": "product",
        "unit": "string"
      }
    ],
    "number": "string",
    "state": "waiting",
    "title": "string",
    "total_ht": 42.0,
    "total_ttc": 42.0,
    "total_tva": 42.0,
    "type": "quote"
  },
  "line": {
    "_id": "string",
    "description": "string",
    "price_ht": 0,
    "quantity": 1,
    "reference": "string",
    "title": "string",
    "total_ht": 0,
    "total_ttc": 0,
    "tva_rate": 42.0,
    "type": "product",
    "unit": "string"
  }
}