User Tools

Site Tools


api

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
api [2021/06/18 11:55] – [Multiple queries exact search] flackapi [2022/04/29 15:04] – [Quote order] flack
Line 162: Line 162:
 ===== InChIKey lookup ===== ===== InChIKey lookup =====
 == Endpoint: == == Endpoint: ==
-<code>/lookup/<inchi_key></code>+<code>/lookup/inchikey/<inchi_key></code>
  
 == Example API request: == == Example API request: ==
Line 345: Line 345:
 http 'https://mcule.com/api/v1/compound/MCULE-9380369173/prices/?amounts=15,20' "Authorization: Token <your_token>" --print HBhb http 'https://mcule.com/api/v1/compound/MCULE-9380369173/prices/?amounts=15,20' "Authorization: Token <your_token>" --print HBhb
 </code> </code>
 +
 +
 +===== Compound list details =====
 +
 +With this endpoint you can get compound details information for multiple compound mcule IDs in a single API call.
 +
 +== Endpoint: ==
 +<code>/compounds/</code>
 +
 +== Basic API request: ==
 +<code>
 +echo '{"mcule_ids": ["MCULE-7655747555","MCULE-5912414227"]}' | http https://mcule.com/api/v1/compounds/ "Authorization: Token <your_token>" --print HBhb
 +</code>
 +
 +
 +== Example API request: ==
 +<code>
 +echo '{"mcule_ids": ["MCULE-7655747555","MCULE-5912414227","MCULE-2570263241"], "price_amounts": [1,5,10], "components": true, "availability": true}' | http https://mcule.com/api/v1/compounds/ "Authorization: Token <your_token>" --print HBhb
 +</code>
 +
 +== Request: ==
 +<code>
 +POST /api/v1/compounds/ HTTP/1.1
 +Authorization: Token <your_token>
 +Content-Type: application/json
 +
 +{
 +    "availability": true,
 +    "components": true,
 +    "mcule_ids": [
 +        "MCULE-7655747555",
 +        "MCULE-5912414227",
 +        "MCULE-2570263241"
 +    ],
 +    "price_amounts": [
 +        1,
 +        5,
 +        10
 +    ]
 +}
 +</code>
 +
 +== Response: ==
 +<code>
 +HTTP/1.1 200 OK
 +Content-Type: application/json
 +
 +{
 +    "count": 3,
 +    "results": [
 +        {
 +            "mcule_id": "MCULE-7655747555",
 +            "smiles": "C1C=C(F)C=C(C2=NC=C(C#N)C=N2)C=1",
 +            "inchi_key": "ZXSZUCRVSWGKCX-UHFFFAOYSA-N",
 +            "best_prices": [],
 +            "mol": "\n  mcule   14092123302D\n\n 15 16  0  0  0  0  0  0  0  0999 V2000\n    8.1579    0.0000    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    6.7983    0.7849    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    6.7983    2.3549    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    8.1579    3.1400    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    9.5175    2.3549    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    9.5175    0.7849    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n   10.8773    3.1400    0.0000 F    0  0  0  0  0  0  0  0  0  0  0\n    5.4386    3.1400    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.0789    2.3549    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    2.7192    3.1400    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    2.7192    4.7100    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.0789    5.4950    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    5.4386    4.7100    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    1.3597    5.4950    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    0.0000    6.2800    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n  1  2  2  0  0  0  0\n  2  3  1  0  0  0  0\n  3  4  2  0  0  0  0\n  4  5  1  0  0  0  0\n  5  6  2  0  0  0  0\n  6  1  1  0  0  0  0\n  5  7  1  0  0  0  0\n  3  8  1  0  0  0  0\n  8  9  1  0  0  0  0\n  9 10  2  0  0  0  0\n 10 11  1  0  0  0  0\n 11 12  2  0  0  0  0\n 12 13  1  0  0  0  0\n 13  8  2  0  0  0  0\n 11 14  1  0  0  0  0\n 14 15  3  0  0  0  0\nM  END",
 +            "availability": {
 +                "confirmed_amount": null,
 +                "availability_type": "in stock",
 +                "confirmed_amount_unit": "mg"
 +            },
 +            "std_inchi": "InChI=1S/C11H6FN3/c12-10-3-1-2-9(4-10)11-14-6-8(5-13)7-15-11/h1-4,6-7H",
 +            "url": "https://mcule.com/MCULE-7655747555/",
 +            "properties": {
 +                "rotatable_bonds": 1,
 +                "h_bond_donors": 0,
 +                "logp": 2.15438,
 +                "r3_violations": 0,
 +                "ct_bonds": 0,
 +                "undef_stereocenters": 0,
 +                "stereocenters": 0,
 +                "rings": 2,
 +                "heavy_atoms": 15,
 +                "r5_violations": 0,
 +                "heteroatoms": 4,
 +                "hydrogens": 6,
 +                "unknown_ct_bonds": 0,
 +                "non_organic_atoms": 0,
 +                "psa": 49.57,
 +                "known_stereocenters": 0,
 +                "atoms": 21,
 +                "unknown_stereocenters": 0,
 +                "halogen_atoms": 1,
 +                "known_ct_bonds": 0,
 +                "h_bond_acceptors": 3,
 +                "refractivity": 52.141,
 +                "mol_mass": 199.183,
 +                "o_and_n_atoms": 3,
 +                "undef_ct_bonds": 0,
 +                "components": 1
 +            },
 +            "stereo_type": "none",
 +            "components": [],
 +            "formula": "C11H6FN3"
 +        },
 +        {
 +            "mcule_id": "MCULE-5912414227",
 +            "smiles": "CN1C(C2N(C(C3N=CC=C(C4CC4)C=3)=O)CCCCC2)=CC=C1",
 +            "inchi_key": "LIJVUQWKZXRMJJ-UHFFFAOYSA-N",
 +            "best_prices": [
 +                {
 +                    "currency": "USD",
 +                    "amount": 1,
 +                    "purity": 90,
 +                    "delivery_time_working_days": 30,
 +                    "price": 310,
 +                    "unit": "mg"
 +                },
 +                {
 +                    "currency": "USD",
 +                    "amount": 5,
 +                    "purity": 90,
 +                    "delivery_time_working_days": 30,
 +                    "price": 330,
 +                    "unit": "mg"
 +                },
 +                {
 +                    "currency": "USD",
 +                    "amount": 10,
 +                    "purity": 90,
 +                    "delivery_time_working_days": 30,
 +                    "price": 355,
 +                    "unit": "mg"
 +                }
 +            ],
 +            "mol": "\n  mcule   14092123302D\n\n 24 27  0  0  0  0  0  0  0  0999 V2000\n    8.4758    5.5126    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    7.6618    5.6478    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    7.2928    6.3856    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    6.4771    6.2627    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    6.3419    5.4488    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    7.0742    5.0687    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    7.1972    4.2529    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    7.9855    4.0098    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    8.2869    3.2418    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    7.8744    2.5274    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    7.0585    2.4043    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    6.4539    2.9656    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    6.5154    3.7883    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    5.8010    4.2008    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    5.8010    5.0258    0.0000 O    0  0  0  0  0  0  0  0  0  0  0\n    5.0866    3.7883    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    5.0866    2.9632    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.3721    2.5507    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.6576    2.9632    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.6576    3.7883    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.3721    4.2008    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    4.3721    1.7257    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.7845    1.0113    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.9596    1.0113    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n  1  2  1  0  0  0  0\n  2  3  1  0  0  0  0\n  3  4  2  0  0  0  0\n  4  5  1  0  0  0  0\n  5  6  2  0  0  0  0\n  2  6  1  0  0  0  0\n  6  7  1  0  0  0  0\n  7  8  1  0  0  0  0\n  8  9  1  0  0  0  0\n  9 10  1  0  0  0  0\n 10 11  1  0  0  0  0\n 11 12  1  0  0  0  0\n 12 13  1  0  0  0  0\n  7 13  1  0  0  0  0\n 13 14  1  0  0  0  0\n 14 15  2  0  0  0  0\n 14 16  1  0  0  0  0\n 16 17  2  0  0  0  0\n 17 18  1  0  0  0  0\n 18 19  2  0  0  0  0\n 19 20  1  0  0  0  0\n 20 21  2  0  0  0  0\n 16 21  1  0  0  0  0\n 18 22  1  0  0  0  0\n 22 23  1  0  0  0  0\n 23 24  1  0  0  0  0\n 22 24  1  0  0  0  0\nM  END",
 +            "availability": {
 +                "confirmed_amount": null,
 +                "availability_type": "potentially purchasable",
 +                "confirmed_amount_unit": "mg"
 +            },
 +            "std_inchi": "InChI=1S/C20H25N3O/c1-22-12-5-7-18(22)19-6-3-2-4-13-23(19)20(24)17-14-16(10-11-21-17)15-8-9-15/h5,7,10-12,14-15,19H,2-4,6,8-9,13H2,1H3",
 +            "url": "https://mcule.com/MCULE-5912414227/",
 +            "properties": {
 +                "rotatable_bonds": 4,
 +                "h_bond_donors": 0,
 +                "logp": 3.9929,
 +                "r3_violations": 4,
 +                "ct_bonds": 0,
 +                "undef_stereocenters": 1,
 +                "stereocenters": 1,
 +                "rings": 4,
 +                "heavy_atoms": 24,
 +                "r5_violations": 0,
 +                "heteroatoms": 4,
 +                "hydrogens": 25,
 +                "unknown_ct_bonds": 0,
 +                "non_organic_atoms": 0,
 +                "psa": 38.13,
 +                "known_stereocenters": 0,
 +                "atoms": 49,
 +                "unknown_stereocenters": 0,
 +                "halogen_atoms": 0,
 +                "known_ct_bonds": 0,
 +                "h_bond_acceptors": 4,
 +                "refractivity": 99.3685,
 +                "mol_mass": 323.431,
 +                "o_and_n_atoms": 4,
 +                "undef_ct_bonds": 0,
 +                "components": 1
 +            },
 +            "stereo_type": "absolute",
 +            "components": [],
 +            "formula": "C20H25N3O"
 +        },
 +        {
 +            "mcule_id": "MCULE-2570263241",
 +            "smiles": "CN1C(C2N(C(C3=C4C(NN=C4)=NC=C3)=O)CCCCC2)=CC=C1",
 +            "inchi_key": "MIRPCBGHLNQNNH-UHFFFAOYSA-N",
 +            "best_prices": [
 +                {
 +                    "currency": "USD",
 +                    "amount": 1,
 +                    "purity": 90,
 +                    "delivery_time_working_days": 30,
 +                    "price": 310,
 +                    "unit": "mg"
 +                },
 +                {
 +                    "currency": "USD",
 +                    "amount": 5,
 +                    "purity": 90,
 +                    "delivery_time_working_days": 30,
 +                    "price": 330,
 +                    "unit": "mg"
 +                },
 +                {
 +                    "currency": "USD",
 +                    "amount": 10,
 +                    "purity": 90,
 +                    "delivery_time_working_days": 30,
 +                    "price": 355,
 +                    "unit": "mg"
 +                }
 +            ],
 +            "mol": "\n  mcule   14092123302D\n\n 24 27  0  0  0  0  0  0  0  0999 V2000\n    3.0777    5.0348    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.6016    4.3976    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    4.4252    4.4469    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.7266    3.6789    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    4.0893    3.1549    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.3941    3.5991    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    2.6261    3.2977    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    2.0213    3.8587    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    1.2056    3.7359    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    0.7931    3.0214    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    1.0945    2.2533    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    1.8828    2.0103    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    2.5645    2.4749    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    3.2789    2.0625    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.9934    2.4749    0.0000 O    0  0  0  0  0  0  0  0  0  0  0\n    3.2789    1.2374    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.9934    0.8250    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.9934   -0.0001    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    3.2789   -0.4125    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    2.5645   -0.0001    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    1.7798   -0.2549    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    1.2949    0.4125    0.0000 N    0  0  0  0  0  0  0  0  0  0  0\n    1.7798    1.0798    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n    2.5645    0.8250    0.0000 C    0  0  0  0  0  0  0  0  0  0  0\n  1  2  1  0  0  0  0\n  2  3  1  0  0  0  0\n  3  4  2  0  0  0  0\n  4  5  1  0  0  0  0\n  5  6  2  0  0  0  0\n  2  6  1  0  0  0  0\n  6  7  1  0  0  0  0\n  7  8  1  0  0  0  0\n  8  9  1  0  0  0  0\n  9 10  1  0  0  0  0\n 10 11  1  0  0  0  0\n 11 12  1  0  0  0  0\n 12 13  1  0  0  0  0\n  7 13  1  0  0  0  0\n 13 14  1  0  0  0  0\n 14 15  2  0  0  0  0\n 14 16  1  0  0  0  0\n 16 17  1  0  0  0  0\n 17 18  2  0  0  0  0\n 18 19  1  0  0  0  0\n 19 20  2  0  0  0  0\n 20 21  1  0  0  0  0\n 21 22  1  0  0  0  0\n 22 23  2  0  0  0  0\n 23 24  1  0  0  0  0\n 16 24  2  0  0  0  0\n 20 24  1  0  0  0  0\nM  END",
 +            "availability": {
 +                "confirmed_amount": null,
 +                "availability_type": "potentially purchasable",
 +                "confirmed_amount_unit": "mg"
 +            },
 +            "std_inchi": "InChI=1S/C18H21N5O/c1-22-10-5-7-15(22)16-6-3-2-4-11-23(16)18(24)13-8-9-19-17-14(13)12-20-21-17/h5,7-10,12,16H,2-4,6,11H2,1H3,(H,19,20,21)",
 +            "url": "https://mcule.com/MCULE-2570263241/",
 +            "properties": {
 +                "rotatable_bonds": 3,
 +                "h_bond_donors": 1,
 +                "logp": 2.9918,
 +                "r3_violations": 3,
 +                "ct_bonds": 0,
 +                "undef_stereocenters": 1,
 +                "stereocenters": 1,
 +                "rings": 4,
 +                "heavy_atoms": 24,
 +                "r5_violations": 0,
 +                "heteroatoms": 6,
 +                "hydrogens": 21,
 +                "unknown_ct_bonds": 0,
 +                "non_organic_atoms": 0,
 +                "psa": 66.81,
 +                "known_stereocenters": 0,
 +                "atoms": 45,
 +                "unknown_stereocenters": 0,
 +                "halogen_atoms": 0,
 +                "known_ct_bonds": 0,
 +                "h_bond_acceptors": 6,
 +                "refractivity": 96.5542,
 +                "mol_mass": 323.392,
 +                "o_and_n_atoms": 6,
 +                "undef_ct_bonds": 0,
 +                "components": 1
 +            },
 +            "stereo_type": "absolute",
 +            "components": [],
 +            "formula": "C18H21N5O"
 +        }
 +    ]
 +}
 +</code>
 +
 +Fields:
 +  * **mcule_ids**: Required. List of mcule IDs. Only compound level mcule IDs are accepted, e.g.: MCULE-7655747555. Mcule IDs that represent other [[structurelevels|structure levels]] (e.g. MCULE-7655747555-0, MCULE-7655747555-0-0, P-611592727) are not accepted.
 +  * **availability**: Optional. Default: false. Whether to return availability information in the response. If you don't need this information you can set it to false (or just leave it out from the request) in order to get a quicker response. Collecting this information can take some time. 
 +  * **components**: Optional. Default: true. Whether to return components information in the response in case the compound has multiple components. If you don't need this information you can set it to false in order to get a slightly quicker response. 
 +  * **price_amounts**: Optional. Default: None. List of amounts (in mg) to return best prices for. Please note that collecting pricing information is an expensive operation.
 +
 +Limits:
 +  * **mcule_ids**: The size of this list is limited to 500. If you specify the **price_amounts** field the limit is reduced to 100 since collecting pricing information is an expensive operation.
 +  * **price_amounts**: The size of this list is limited to 5. 
 +
  
  
Line 817: Line 1066:
   * **higher_amounts**: Set to true if you would like to get a quote for the compounds in the largest possible quantity in case they do not cost more than the specified amount. (default: false)   * **higher_amounts**: Set to true if you would like to get a quote for the compounds in the largest possible quantity in case they do not cost more than the specified amount. (default: false)
   * **item_filters**: Per query item filters. Currently it supports only supplier filtering. See example below.   * **item_filters**: Per query item filters. Currently it supports only supplier filtering. See example below.
 +  * **scheme**: If you have access to predefined / pre-negotiated quote request schemes, you can specify here which one you want to use. You have to send the ID of the scheme which will be provided to you after negotiation. A quote query scheme is essentially a template that contains predefined quote query parameters, or even include private parameters that affect quote generation in various ways (e.g.: discounts, predefined custom prices). These parameters can be customized for your use case. The scheme might already contain mandatory fields like delivery_country. In this case you don't have to specify them again, they will be applied from the scheme. Any explicitly specified public parameter during the request will override the one that comes from the specified scheme. 
  
 The **amount** or target concentration-volume pair (**target_volume** and **target_cc**) need to be specified. The **amount** or target concentration-volume pair (**target_volume** and **target_cc**) need to be specified.
Line 880: Line 1130:
     "delivery_contact_person_name": "",      "delivery_contact_person_name": "", 
     "delivery_contact_person_phone": "",      "delivery_contact_person_phone": "", 
-    "delivery_country": "US", +    "delivery_country": "US", 
 +    "delivery_format_display": "Dry powder/film in supplier vial", 
     "delivery_post_code": "",      "delivery_post_code": "", 
     "delivery_time": 21,      "delivery_time": 21, 
Line 950: Line 1201:
     "delivery_contact_person_phone": "",      "delivery_contact_person_phone": "", 
     "delivery_country": "US",      "delivery_country": "US", 
 +    "delivery_format_display": "Dry powder/film in supplier vial", 
     "delivery_post_code": "",      "delivery_post_code": "", 
     "delivery_time": 21,      "delivery_time": 21, 
Line 1127: Line 1379:
  
 { {
 +    "additional_document_notes": "",
 +    "amount_range": [1, 1],
 +    "amount_range_display": "1",
     "analytical_services_price": "0.00",      "analytical_services_price": "0.00", 
     "api_url": "https://mcule.com/api/v1/iquotes/15677/",      "api_url": "https://mcule.com/api/v1/iquotes/15677/", 
Line 1190: Line 1445:
             "price": "144.45",              "price": "144.45", 
             "product": 505393003,             "product": 505393003,
 +            "product_available_amount": null,
 +            "product_available_amount_display": "In stock",
             "product_catalog_id": 156,             "product_catalog_id": 156,
             "product_catalog_name": "Building Blocks",              "product_catalog_name": "Building Blocks", 
Line 1196: Line 1453:
             "product_price": "35.18",              "product_price": "35.18", 
             "product_purity": 98,              "product_purity": 98, 
 +            "product_smiles": "CCC(NCC[C@H]1C2=C(C=CC3=C2CCO3)CC1)=O",
             "product_supplier_id": 37,             "product_supplier_id": 37,
             "product_supplier_name": "AK Scientific",             "product_supplier_name": "AK Scientific",
Line 1207: Line 1465:
             "id": 1740172,              "id": 1740172, 
             "price": "97.32",              "price": "97.32", 
 +            "product": 346316287, 
 +            "product_available_amount": null,
 +            "product_available_amount_display": "In stock",
             "product_catalog_id": 6,             "product_catalog_id": 6,
             "product_catalog_name": "Advanced Collection",             "product_catalog_name": "Advanced Collection",
-            "product": 346316287,  
             "product_compound_mcule_id": "MCULE-3906582667",              "product_compound_mcule_id": "MCULE-3906582667", 
             "product_mcule_id": "P-346316287",              "product_mcule_id": "P-346316287", 
             "product_price": "95.94",              "product_price": "95.94", 
             "product_purity": 90,              "product_purity": 90, 
 +            "product_smiles": "CC1N(C(C2NCCC2)=O)CC(C2=C(C)C=CC=C2)C1.Cl",
             "product_supplier_id": 3,             "product_supplier_id": 3,
             "product_supplier_name": "Enamine",             "product_supplier_name": "Enamine",
Line 1226: Line 1487:
             "price": "97.32",              "price": "97.32", 
             "product": 346567071,              "product": 346567071, 
 +            "product_available_amount": null,
 +            "product_available_amount_display": "In stock",
             "product_catalog_id": 6,             "product_catalog_id": 6,
             "product_catalog_name": "Advanced Collection",             "product_catalog_name": "Advanced Collection",
Line 1232: Line 1495:
             "product_price": "95.94",              "product_price": "95.94", 
             "product_purity": 90,              "product_purity": 90, 
 +            "product_smiles": "FC1=C(N2CC3=C(C=CC=C3)OCC2)N=CC=C1",
             "product_supplier_id": 3,             "product_supplier_id": 3,
             "product_supplier_name": "Enamine",             "product_supplier_name": "Enamine",
Line 1244: Line 1508:
             "price": "97.32",              "price": "97.32", 
             "product": 346206264,              "product": 346206264, 
 +            "product_available_amount": null,
 +            "product_available_amount_display": "In stock",
             "product_catalog_id": 6,             "product_catalog_id": 6,
             "product_catalog_name": "Advanced Collection",             "product_catalog_name": "Advanced Collection",
Line 1250: Line 1516:
             "product_price": "95.94",              "product_price": "95.94", 
             "product_purity": 90,             "product_purity": 90,
 +            "product_smiles": "OC(C1(C2=C(C(F)(F)F)C=CC=C2)CC1)=O",
             "product_supplier_id": 3,             "product_supplier_id": 3,
             "product_supplier_name": "Enamine",              "product_supplier_name": "Enamine", 
Line 1262: Line 1529:
             "price": "416.37",              "price": "416.37", 
             "product": 580505383,              "product": 580505383, 
 +            "product_available_amount": null,
 +            "product_available_amount_display": "Potentially purchasable (60-80%)",
             "product_catalog_id": 202,             "product_catalog_id": 202,
             "product_catalog_name": "Compounds on demand",             "product_catalog_name": "Compounds on demand",
Line 1268: Line 1537:
             "product_price": "293.45",              "product_price": "293.45", 
             "product_purity": null,              "product_purity": null, 
 +            "product_smiles": "OC(C1(C2=C(C(F)(F)F)C=CC=C2)CC1)=O",
             "product_supplier_id": 33,             "product_supplier_id": 33,
             "product_supplier_name": "Manchester Organics",             "product_supplier_name": "Manchester Organics",
Line 1333: Line 1603:
         "delivery_contact_person_phone": "",          "delivery_contact_person_phone": "", 
         "delivery_country": "US",          "delivery_country": "US", 
 +        "delivery_format_display": "Dry powder/film in supplier vial",
         "delivery_post_code": "",          "delivery_post_code": "", 
         "delivery_time": 21,          "delivery_time": 21, 
Line 1424: Line 1695:
 Where currency is not specified, it is always USD. Where currency is not specified, it is always USD.
  
 +  * **additional_document_notes**: additional document notes if there are any
 +  * **amount_range**: Amount / product (mg), min - max product amounts as a list
 +  * **amount_range_display**: Amount / product (mg) as string
   * **analytical_services_price**: price of analytical services (USD)   * **analytical_services_price**: price of analytical services (USD)
   * **avg_product_price**: Average product price (USD)   * **avg_product_price**: Average product price (USD)
Line 1447: Line 1721:
     * **effective_price_display**: Total price change if excluded this product. (USD) It shows how the total price will change upon removal of the product. In addition to the product price, this may include delivery cost, packaging fees, small / minimum order fees, etc     * **effective_price_display**: Total price change if excluded this product. (USD) It shows how the total price will change upon removal of the product. In addition to the product price, this may include delivery cost, packaging fees, small / minimum order fees, etc
     * **price**: effective price     * **price**: effective price
 +    * **product_available_amount**: concrete available amount (mg) data if available,
 +    * **product_available_amount_display**: availability display, e.g.: In stock, Potentially purchasable (60-80%),
     * **product_mcule_id**: The mcule ID of the quoted product.     * **product_mcule_id**: The mcule ID of the quoted product.
     * **product**: The ID of the quoted product (should be neglected).     * **product**: The ID of the quoted product (should be neglected).
Line 1453: Line 1729:
     * **product_price**: Product price (USD)     * **product_price**: Product price (USD)
     * **product_purity**: Minimum purity (%)     * **product_purity**: Minimum purity (%)
 +    * **product_smiles**: SMILES of the product
     * **structure_origin_mcule_id**: The mcule ID of the query molecule.     * **structure_origin_mcule_id**: The mcule ID of the query molecule.
     * **quote**: The ID of the quote this product level quote data belongs to.     * **quote**: The ID of the quote this product level quote data belongs to.
   * **name**: The name of the quote. Quotes created via the API don't have names.   * **name**: The name of the quote. Quotes created via the API don't have names.
-  * **order_data**: Order data. (Should be neglected).+  * **order_data**: If the quote has been ordered, data related to the purchase order is provided here. 
 +    * **billing_address**: Billing address 
 +    * **billing_city**: Billing city 
 +    * **billing_company_name**: Billing Institution / Company name 
 +    * **billing_country**: Billing country 
 +    * **billing_post_code**: Billing ZIP / Post code 
 +    * **billing_state**: Billing State / Province 
 +    * **billing_email**: Billing contact email 
 +    * **billing_first_name**: Billing contact first name 
 +    * **billing_last_name**: Billing contact last name 
 +    * **billing_phone**: Billing contact phone number 
 +    * **billing_same**: Whether the billing data is the same is shipping data 
 +    * **billing_vat**: Billing VAT number 
 +    * **shipping_address**: Shipping address 
 +    * **shipping_city**: shipping city 
 +    * **shipping_company_name**: Shipping Institution / Company name 
 +    * **shipping_country**: Shipping country 
 +    * **shipping_post_code**: Shipping ZIP / Post code 
 +    * **shipping_state**: Shipping State / Province 
 +    * **shipping_email**: Shipping contact email 
 +    * **shipping_first_name**: Shipping contact first name 
 +    * **shipping_last_name**: Shipping contact last name 
 +    * **shipping_phone**: Shipping contact phone number 
 +    * **notes**: notes 
 +    * **po_number**: Customer Purchase Order number 
 +    * **po_file_filename**: In case a Purchase Order file was submitted, the name of the filename. 
 +    * **po_option**: Purchase Order option (10: Upload PO, 20: Order without PO, 30: Send PO later) 
 +    * **po_option_display**: Purchase Order option as string 
 +    * **created**: Datetime when the purchase order was submitted 
 +    * **updated**: Datetime when the purchase order data was updated 
 +    * **id**: ID of the purchase order data
   * **payment_due_days**: Payment terms. Number of days net or prepayment by credit card   * **payment_due_days**: Payment terms. Number of days net or prepayment by credit card
   * **price**: Total price of quote (USD)   * **price**: Total price of quote (USD)
Line 1553: Line 1860:
 </code> </code>
  
 +
 +===== Quote order =====
 +
 +Submit purchase order for a quote via API.
 +
 +<code>
 +http --form POST https://mcule.com/api/v1/iquotes/15677/order/ po_option=10 po_file@~/po.pdf "Authorization: Token <your_token>" --print HBhb
 +</code>
 +
 +== Example request: ===
 +<code>
 +POST /api/v1/iquotes/15677/order/ HTTP/1.1
 +Accept: */*
 +Accept-Encoding: gzip, deflate
 +Authorization: Token <your_token>
 +Content-Type: multipart/form-data; boundary=b582e4472c434fd6b30b265ffef125e8
 +
 ++-----------------------------------------+
 +| NOTE: binary data not shown in terminal |
 ++-----------------------------------------+
 +</code>
 +
 +Please note that in case you submit a file in the API request, you have to use //Content-Type: multipart/form-data// as you can see at the above request.
 +
 +If you don't submit a file in the API request, you can use //Content-Type: application/json// :
 +
 +<code>
 +echo '{"po_option": 20, "shipping_country": "US", "shipping_first_name": "John", "shipping_last_name": "Doe"}' | http https://mcule.com/api/v1/iquotes/15677/order/ "Authorization: Token <your_token>" --print HBhb
 +</code>
 +
 +== Example request: ===
 +<code>
 +POST /api/v1/iquotes/15677/order/ HTTP/1.1
 +Accept: application/json, */*
 +Authorization: Token <your_token>
 +Content-Type: application/json
 +{
 +    "po_option": 20,
 +    "shipping_country": "US",
 +    "shipping_first_name": "John",
 +    "shipping_last_name": "Doe"
 +}
 +</code>
 +
 +== Example response: ===
 +<code>
 +HTTP/1.0 201 CREATED
 +Allow: POST, OPTIONS
 +Content-Type: application/json
 +
 +{
 +    "billing_address": "",
 +    "billing_city": "",
 +    "billing_company_name": "",
 +    "billing_country": "",
 +    "billing_email": "",
 +    "billing_first_name": "",
 +    "billing_last_name": "",
 +    "billing_phone": "",
 +    "billing_post_code": "",
 +    "billing_same": true,
 +    "billing_state": "",
 +    "billing_vat": "",
 +    "created": "2022-04-29T17:02:09.257359",
 +    "id": 3691,
 +    "notes": "",
 +    "po_file_filename": "",
 +    "po_number": "",
 +    "po_option": 20,
 +    "po_option_display": "Order without PO",
 +    "shipping_address": "",
 +    "shipping_city": "",
 +    "shipping_company_name": "",
 +    "shipping_country": "US",
 +    "shipping_email": "",
 +    "shipping_first_name": "John",
 +    "shipping_last_name": "Doe",
 +    "shipping_phone": "",
 +    "shipping_post_code": "",
 +    "shipping_state": "",
 +    "updated": "2022-04-29T17:02:09.257373"
 +}
 +</code>
 +
 +
 +Mandatory fields:
 +    * **po_option**: Purchase Order option (10: Upload PO, 20: Order without PO, 30: Send PO later)
 +
 +Optional fields:
 +    * **billing_address**: Billing address
 +    * **billing_city**: Billing city
 +    * **billing_company_name**: Billing Institution / Company name
 +    * **billing_country**: Billing country
 +    * **billing_post_code**: Billing ZIP / Post code
 +    * **billing_state**: Billing State / Province
 +    * **billing_email**: Billing contact email
 +    * **billing_first_name**: Billing contact first name
 +    * **billing_last_name**: Billing contact last name
 +    * **billing_phone**: Billing contact phone number
 +    * **billing_same**: Whether the billing data is the same as shipping data
 +    * **billing_vat**: Billing VAT number
 +    * **shipping_address**: Shipping address
 +    * **shipping_city**: Shipping city
 +    * **shipping_company_name**: Shipping Institution / Company name
 +    * **shipping_country**: Shipping country
 +    * **shipping_post_code**: Shipping ZIP / Post code
 +    * **shipping_state**: Shipping State / Province
 +    * **shipping_email**: Shipping contact email
 +    * **shipping_first_name**: Shipping contact first name
 +    * **shipping_last_name**: Shipping contact last name
 +    * **shipping_phone**: Shipping contact phone number
 +    * **notes**: notes
 +    * **po_number**: Customer Purchase Order number
 +    * **po_file**: Purchase Order document file.
 +
 +The address and contact fields are optional if this information is included in the Purchase Order document or will be provided later to our support team. Although providing the shipping and billing address / contact information here can speed up the ordering process, if you decide to leave them empty, our support team will contact you to reconcile this information. 
 +
 +Subsequent calls to this same endpoint make it possible to update the purchase order information. You can also report incorrect data at order@mcule.com. Please make sure you reference the quote's Full reference ID (**reference_id_full** field in the corresponding API response) in your email.
  
  
api.txt · Last modified: 2023/06/03 07:19 by flack