MKG API Inkooporder

Getest op API V3 en MKG Versie 005.91.014.

---

Inhoudsopgave Opvragen Inkooporders ophalen Inkooporderregels ophalen  Lijst met inkopers Aanmaken Inkooporderheader Inkooporderregel Acties Inkooporderregel accepteren Inkooporderregel bevestigen Inkooporderregel bestellen Vernieuw VC-prijzen

---

Data dictionary Voor informatie over endpoints, velden en acties, zie dit artikel.

 

Postman Voor voorbeelden van API-aanroepen, zie dit artikel.

 

Opvragen

Crediteur Voor het opvragen van een crediteur, zie dit artikel.

 

Inkooporders ophalen

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

GET {{restUrl}}/Documents/iorh

• Fieldlist: admi_num,iorh_num,iorr_num,iorr_cred,cred_num,iorr_dat_ontvangst
• NumRows: 1000

{{restUrl}}/Documents/iorh/?NumRows=1000&FieldList=admi_num,iorh_num,iorr_num,iorr_cred,cred_num,iorr_dat_ontvangst

 

Inkooporderregels ophalen

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

GET {{restUrl}}/Documents/iorh

• Fieldlist: iorh_num,iorr_num,iorr_cred,t_iorh_cred,iorr_uitbesteding,iorr_verh_aantal_aantal_grp,iorr_backorder_aantal
• NumRows: 1000

{{restUrl}}/Documents/iorr/?NumRows=1000&FieldList=iorh_num,iorr_num,iorr_cred,t_iorh_cred,iorr_uitbesteding,iorr_verh_aantal_aantal_grp,iorr_backorder_aantal

 

Lijst met inkopers

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

GET {{restUrl}}/Documents/inkr

• Fieldlist: medw_num,inkr_naam,inkr_num
• NumRows: 10

{{restUrl}}/Documents/inkr/?Fieldlist=medw_num,inkr_naam,inkr_num&NumRows=10

 

Aanmaken

 

Crediteur Voor het aanmaken van een crediteur, zie dit artikel.

 

Inkooporderheader

Voor het aanmaken van een inkooporder moet een crediteur zijn aangemaakt waar deze aan wordt gekoppeld. De crediteur wordt gekoppeld met de variabele {{cred_num}}. 

POST {{restUrl}}/Documents/iorh

{{restUrl}}/Documents/iorh

Request body:

{
    "request": {
        "InputData": {
            "iorh": [
                {
                    "admi_num": {{admi_num}},
                    "cred_num": {{cred_num}},
                    "inkr_num": "Inkoper",
                    "iorh_ref_onze": "Our reference",
                    "iorh_ref_uw": "Creditor reference",
                    "iorh_ordernummer_extern": "Customer order code",
                    "iorh_dat_order": "31-12-2025",
                    "iorh_dat_ontvangst": "31-12-2025",
                    "iorh_dat_bevestigd": "31-12-2025"
                }
            ]
        }
    }
}

 

Inkooporderregel

Voor het aanmaken van een inkooporderregel moet er een inkooporder zijn aangemaakt waar deze aan wordt gekoppeld. Deze inkooporder wordt gekoppeld met de variabele {{iorh_num}}.

POST {{restUrl}}/Documents/iorh/{{iorh_num}}/iorh_iorr/

{{restUrl}}/Documents/iorh/{{iorh_num}}/iorh_iorr/

Request body:

{
    "request": {
        "InputData": {
            "iorr": [
                {
                    "admi_num": {{admi_num}},
                    "iorh_num": {{iorh_num}},
                    "arti_code": "Artikel",
                    "iorr_oms_1": "Sales order line",
                    "iorr_order_aantal": 100,
                    "iorr_eenh_order": "st."
                    "btwc_code": 1
                }
            ]
        }
    }
}

 

Acties

 

Inkooporderregel accepteren

In MKG is het mogelijk om een inkooporderregel te accepteren. Dit kan, zowel voor één regel, als voor meerdere regels tegelijk. Het accepteren van een inkooporderregel zorgt ervoor dat deze regel wordt vastgelegd en geaccepteerd. Daarmee is de regel goedgekeurd en klaar voor verdere verwerking.

Voor het accepteren van één inkooporderregel maak je gebruik van de volgende call:

PUT{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorhnum}}+{{iorrnum}}/Service/s_actie_accepteren?FieldList=iorr_num 

{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorhnum}}+{{iorrnum}}/Service/s_actie_accepteren?FieldList=iorr_num

 

Voor het accepteren van meerdere inkooporderregels maak je gebruik van de volgende call:

PUT{{restUrl}}/Documents/iorr/0/Service/s_actie_accepteren

{{restUrl}}/Documents/iorr/0/Service/s_actie_accepteren

Request body:

{
    "request": {
        "InputData": {
            "t_selected_rows": [
                {
                    "t_value": "0x0000000003d6bc43"
                },
                {
                    "t_value": "0x0000000003d6bc44"
                }
            ]
        }
    }
}

 

Inkooporderregel bevestigen

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

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

PUT{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorhnum}}+{{iorrnum}}/Service/s_actie_bevestigen?FieldList=iorr_num 

{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorhnum}}+{{iorrnum}}/Service/s_actie_bevestigen?FieldList=iorr_num

 

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

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

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

Request body:

{
    "request": {
        "InputData": {
            "t_selected_rows": [
                {
                    "t_value": "0x0000000003c86e8b"
                },
                {
                    "t_value": "0x0000000003c86e8c"
                }
            ]
        }
    }
}

 

Inkooporderregel bestellen

In MKG is het mogelijk om een inkooporderregel te bestellen. Dit kan, zowel voor één regel, als voor meerdere regels tegelijk. Het bestellen van een inkooporderregel zorgt ervoor dat deze regel wordt besteld bij de voorkeursleverancier/-crediteur. De regel is dan besteld en klaar voor verdere verwerking.

Voor het bestellen van één inkooporderregel maak je gebruik van de volgende call:

PUT{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorh_num}}+{{iorr_num}}/Service/s_actie_in_bestelling

{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorh_num}}+{{iorr_num}}/Service/s_actie_in_bestelling

 

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

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

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

Request body:

{
    "request": {
        "InputData": {
            "t_selected_rows": [
                {
                    "t_value": "0x0000000003c86e8b"
                },
                {
                    "t_value": "0x0000000003c86e8c"
                }
            ]
        }
    }
}

 

Vernieuw VC-prijzen

Soms moet je de voorcalculatieprijzen verversen, als er wijzigingen hebben plaatsgevonden. Dit kan je doen met de service s_refresh_prices. Deze service roep je aan met de volgende call:

PUT{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorh_num}}+{{iorr_num}}/Service/s_refresh_prices

{{restUrl}}/Documents/iorr/{{admi_num}}+{{iorhnum}}+{{iorrnum}}/Service/s_refresh_prices