MKG API Verkooporder

Getest op API V3 en MKG Versie 005.90.002.

Opvragen

Lijst met verkopers

Voor het opvragen van een lijst met verkopers kan de volgende aanroep worden gebruikt. De API maakt gebruik van paginering, waarbij maximaal 1000 regels in één aanroep worden aangeboden.

GET {{restUrl}}/Documents/verk

• Fieldlist: medw_num,verk_naam,verk_num
• NumRows: 10

{{restUrl}}/Documents/verk/?Fieldlist=medw_num,verk_naam,verk_num&NumRows=10

Aanmaken

Verkooporder header

Voor het aanmaken van een verkooporder moet een debiteur zijn aangemaakt waar deze aan wordt gekoppeld. De debiteur wordt gekoppeld met de variabel {{debi_num}}. 

POST {{restUrl}}/Documents/vorh

{{restUrl}}/Documents/vorh

Request body:

{
    "request": {
        "InputData": {
            "vorh": [
                {
                    "admi_num": {{admi_num}},
                    "debi_num": {{debi_num}},
                    "verk_num": "Verkoper",
                    "vorh_ref_onze": "Our reference",
                    "vorh_ref_uw": "Customer reference",
                    "vorh_bestelcode_extern": "Customer order code",
                    "vorh_dat_order": "31-12-2025",
                    "vorh_dat_gewenst": "31-12-2025"
                }
            ]
        }
    }
}

Verkooporderregel

Voor het aanmaken van een verkooporderregel moet er een verkooporder zijn aangemaakt waar deze aan wordt gekoppeld. Deze verkooporder wordt gekoppeld met de variabel {{vorh_num}}.

POST {{restUrl}}/Documents/vorr

{{restUrl}}/Documents/vorr

Request body:

{
    "request": {
        "InputData": {
            "vorr": [
                {
                    "admi_num": {{admi_num}},
                    "vorh_num": {{vorh_num}},
                    "arti_code": "Artikel",
                    "vorr_oms_1": "Sales order line",
                    "vorr_order_aantal": 100,
                    "vorr_eenh_order": "st."
                    "btwc_code": 1
                }
            ]
        }
    }
}

Acties

Verkooporderregel bevestigen

In MKG is het mogelijk om een verkooporderregel te bevestigen. Dit kan, zowel voor één regel, als voor meerdere regels tegelijk. Het bevestigen van een verkooporderregel zorgt ervoor dat deze regel wordt vastgelegd en bevestigd aan de klant. De regel is dan goedgekeurd en klaar voor verdere verwerking, zoals productie, inkoop of levering.

Voor het bevestigen van één verkooporderregel maak je gebruik van de volgende call:

PUT{{restUrl}}/Documents/vorr/{{admi_num}}+{{vorhnum}}+{{vorr_num}}/Service/s_actie_bevestigen

{{restUrl}}/Documents/vorr/{{admi_num}}+{{vorhnum}}+{{vorr_num}}/Service/s_actie_bevestigen

Voor het bevestigen van meerdere verkooporderregels maak je gebruik van de volgende call:

PUT{{restUrl}}/Documents/vorr/0/Service/s_actie_bevestigen

{{restUrl}}/Documents/vorr/0/Service/s_actie_bevestigen

Request body:

{
    "request": {
        "InputData": {
            "t_selected_rows": [
                {
                    "t_value": "0x0000000003c86e8b"      // RowKey from vorr_num
                },
                {
                    "t_value": "0x0000000003c86e8c"     // RowKey from vorr_num
                }
            ]
        }
    }
}

Productieorder aanmaken

PUT {{restUrl}}/Documents/vorr/1+{{vorh_num}}+{{vorr_num}}/Service/s_createproductionorder

{{restUrl}}/Documents/vorr/1+{{vorh_num}}+{{vorr_num}}/Service/s_createproductionorder

Inkooporder aanmaken

Put {{restUrl}}/Documents/vorr/1+{{vorh_num}}+{{vorr_num}}/Service/s_createpurchaseorder

{{restUrl}}/Documents/vorr/1+{{vorh_num}}+{{vorr_num}}/Service/s_createpurchaseorder

Reservering aanmaken

PUT {{restUrl}}/Documents/vorr/{{admi_num}}+{{vorh_num}}+{{vorr_num}}/Service/s_createreservation

{{restUrl}}/Documents/vorr/{{admi_num}}+{{vorh_num}}+{{vorr_num}}/Service/s_createreservation

Request body:

{
    "request": {
        "InputData": {
            "Reservation": [
                {
                    "t_eenh_reserveren": "st.",
                    "t_afgewerkt": true,
                    "Rowkey": 1
                }
            ],
            "StockAvailableList": [
                {
                    "RowKey": 1,
                    "t_ingave": 1,
                    "t_pamt_row": "{{part_num}}"
                }
            ]
        }
    }
}