1. 1.5 - Header + Query Param
ERPConnector
ERPConnector - Public doc
  • ERPConnector - Public doc
  • 1 - Informations générales
    • 1.1 - Survol
    • 1.2 - CodeLicence, Company, CléSecrete
    • 1.3 - Authentification
    • 1.4 - Versions de l'API
      • GetBasicApiInfo
    • 1.5 - Header + Query Param
      • Header - COMPANY_CODE
      • Header - RETURN_FULL_PAYLOAD
      • PUT vs POST
      • Query - $select
      • Pagination dans l'API
  • 2 - Accounting (GL)
    • 2.1 - GL Account
      • GL Account
    • 2.2 - GL Project
      • GLProject
      • GLProjectBalance
      • Create GLProjet
    • 2.3 - GL Journal Entry
      • GL Journal Entry
      • GL Journal Entry (Sage50)
  • 3 - Account Receivable (Customers)
    • 3.1 - Customer (client)
      • Customer
      • Create customer
      • Modify Customer
    • 3.2 - Customer Group
      • CustomerGroup
    • 3.3 - Customer Order (Commandes cliente)
      • CustomerOrder
      • CustomerOrder
      • CustomerOrder
    • 3.4 - Customer Invoice (Facture client)
      • CustomerInvoices
      • Create CustomerInvoice
      • Create CustomerInvoice (AR Invoice)
    • 3.5 - SalesRep (Vendeurs)
      • SalesRep
    • 3.6 - Territory (Territoires)
      • Territory
    • 3.7 - PaymentMode (Mode de paiement)
      • CustomerPaymentMode
    • 3.8 - Customer Project
      • Project
    • 3.9 - Customer Bid (Soumission cliente)
      • Get CustomerBid
      • Create CustomerBid
    • 3.10 - Customer Invoice Payment (Règlement facture cliente)
      • Get CustomerInvoicePayment
      • Create CustomerInvoicePayment (Acomba)
    • 3.11 - Customer Service Contract (Contrat de service)
      • Get CustomerInvoicePayment Copy
    • 3.12 - CustomerARInvoices (Transaction GL Cliente)
      • Extract InvoiceAR
      • Create CustomerInvoice (AR Invoice) Copy
  • 4 - Account Payable (Compte Payable/fournisseur)
    • 4.1 - Supplier (Fournisseur)
      • Supplier
      • Create Supplier
      • Modify Supplier
    • 4.2 - Supplier Invoice (Facture Fournisseur)
      • SupplierInvoice
      • Supplier Invoice
    • 4.3 - Supplier Order (Achat fournisseur)
      • SupplierOrder
      • Create SupplierOrder
    • 4.4 - Supplier Invoice Payment (Paiement Fournisseur)
      • SupplierInvoicePayment
      • SupplierInvoicePayment (Avantage)
    • 4.5 - Product Supplier (Produit-Fournisseur)
      • Get Supplier Products
      • Create SupplierProduct
      • Modify SupplierProduct
    • 4.6 - SupplierOrderReceipt (Réception Achat)
      • SupplierOrderReceipt (Réception Acomba)
  • 5 - Inventory (Produits)
    • 5.1 - Product (Produit)
      • Product - Get METADATA information
      • Product
      • Product Creation
      • Product Modif
    • 5.2 - ProductGroup (Groupe de produit)
      • ProductGroup
    • 5.3 - Product Trail
      • ProductTrail
      • Create ProductTrail
    • 5.4 - Product Serial
      • Get - Product Serial (Acomba)
  • 6 - HR (Ressource Humaine)
    • 6.1 - Employee
      • Employee
    • 6.2 - Employee Payroll
      • Employee Payroll
  • 7 - ERPConnectorTask (Direct)
    • GET SupplierOrder (achat) ErpConnectorTask
    • Extract Customer
    • Extract Customer
    • GET Supplier - ErpConnectorTask
  • 8 - Miscellaneous
    • 8.1 - Taxes
      • Tax
      • TaxGroup
    • 8.2 - Company Info
      • CompanyInfo
    • 8.3 WorkOrder (Servicentre / Servex)
      • 8.3.1 WorkOrder Sub Entities (Servex)
        • Get WorkOrderStatus (Servex)
        • Get WorkOrderTechnician (Servex)
        • Get WorkOrderDispatcher (Servex)
      • Get WorkOrder
      • Post WorkOrder (Servex)
    • 8.4 Equipment (Servicentre)
      • Get Equipment
    • 8.5 Activity (Avantage)
      • Get Activity
    • 8.6 FinancialTransaction (QBO)
      • Read FinancialTransaction (QBO - BankDeposit)
      • Create FinancialTransaction (QBO - BankDeposit)
  • 99 - System
    • Quickbooks Online
      • QuickBooks - GetRefreshQBOAccessTokens
      • QuickBooks - Get QBO GetQBOConnexionInfo
      • QuickBooks - Auth - ConnectToQBORedirect
      • QuickBooks - ExecuteRawSQL
    • Relational Database
      • Relational Db - ExecuteRawSQL
    • Acomba
      • Test ERP Connection
  1. 1.5 - Header + Query Param

PUT vs POST

Comprendre l’usage de POST et PUT dans ERP Connector#

Dans l’API ERP Connector / OnlineERP, la création et la mise à jour des entités respectent les standards RESTful.
POST : sert exclusivement à créer une ressource.
PUT : sert à créer ou remplacer une ressource à une URI donnée. Autrement dit, si la ressource existe, elle est remplacée ; si elle n’existe pas, elle est créée. Ce comportement est reconnu comme valide et conforme aux spécifications REST.
Cette approche suit la définition du verbe PUT telle que décrite dans la documentation HTTP officielle de MDN :
“The HTTP PUT request method creates a new resource or replaces a representation of the target resource with the request payload.”

Contrôler finement le comportement avec les préconditions HTTP#

Il est également possible de restreindre le comportement de PUT à l’aide des headers standards :
If-Match: \\\* → autorise uniquement une mise à jour (erreur si la ressource n’existe pas).
If-None-Match: \\\* → autorise uniquement une création (erreur si la ressource existe déjà).
Ces en-têtes font partie du standard HTTP et offrent un contrôle précis, sans nécessiter d’extensions propriétaires.
EndFragment
Previous
Header - RETURN_FULL_PAYLOAD
Next
Query - $select
Built with