Van uw software naar klanten

Een eenvoudige tweeweg datastroom

Uw systeem blijft de bron van uw bedrijfsgegevens. Het voedt de winkel van SellViaApp terwijl door de klant bevestigde orders terugvloeien naar uw ERP of zakelijke software.

1

Uw ERP

Producten, categorieën, prijzen en inhoud.

2

API SellViaApp

Beveilig JSON uitwisselingen via HTTPS.

3

Mobiele app

Klanten bladeren en plaatsen bestellingen.

4

Uw orders

Uw systeem haalt ze automatisch op.

Geen dubbele ingang

Externe identificaties behouden de mapping naar uw ERP-referenties, terwijl paginatie grote synchronisaties betrouwbaar houdt.

Snel starten

Sluit uw systeem in drie stappen aan

1

Haal je referenties

De API sleutel identificeert uw winkel. De beheerder token beschermt server operaties.

2

Geef de catalogus

Creëer categorieën, stuur of update producten van uw ERP.

3

Bevelen ophalen

Bekijk de gepagineerde leverancier route en bewaar elke verwerkte GUID.

Maak een product · cURL

curl -X POST "https://api.sellviaapp.com/product/add" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -d '{
    "external_key": "ERP-ARTICLE-1042",
    "code": "ART-1042",
    "name": "Premium product",
    "description": "Complete product description",
    "base_price": 24.90,
    "vat_rate": 21,
    "category_id": 12,
    "active": true
  }'

Bestellingen ophalen · cURL

curl "https://api.sellviaapp.com/admin/order/list?page=1&per_page=25&from_date=2026-08-01" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Elke bestelling bevatGUID, aantal, klant, lijnen, hoeveelheden, prijzen, BTW, totaal, valuta, vervullingmodus, adres en datum.

Beveiliging

Afzonderlijke referenties voor elk gebruik

BELANGRIJKSTE

X-API-Key

Vereist om de leverancier te identificeren. Laat nooit de sleutel in publiek JavaScript.

JWT

Autorisatie: drager

Vereist voor ingelogde klantgegevens. Vernieuwen via auth/refresh.

ADM

X-Admin-Token

Gereserveerd voor goedgekeurde serverintegraties die catalogi en categorieën wijzigen.

Alleen server-side integratie

Houd X-API-Key en X-Admin-Token in uw server of ERP. Plaats ze nooit in een openbare website, mobiele app of bron repository.

Eindpunten

Authenticatie

Maak, ververs en sluit beveiligde sessies.

POST /auth/login API-sleutel

Een klant aanmelden met hun login en wachtwoord.

POST /auth/refresh API-sleutel

Een toegangsteken vernieuwen met een ververs token.

POST /auth/logout Sleutel + drager

De actieve sessie sluiten.

POST /auth/guest API-sleutel

Maak een gastsessie aan als deze door de leverancier is ingeschakeld.

POST /auth/forgot-password API-sleutel

Begin account recovery zonder te vermelden of er een account bestaat.

Eindpunten

Leveranciers en merken

Vind een winkel en haal zijn publieke configuratie.

GET /admin/supplier/list Openbaar

Zoek leveranciers zichtbaar in de directory.

GET /admin/supplier/logo Openbaar

Haal een geoptimaliseerd leverancierslogo op.

GET /admin/supplier/contact API-sleutel

Geconfigureerde contactgegevens van het publiek ophalen.

GET /admin/supplier/legal API-sleutel

Ophalen van voorwaarden, privacy, juridische kennisgeving en over inhoud.

GET /admin/megawinappcheck/check_supplier_to_use Openbaar

Een leverancier uit een achtervoegsel of identificatienummer op te lossen.

Eindpunten

Klanten

Maak en beheer klantaccounts voor elke winkel.

POST /customer/add API-sleutel

Maak een klant en genereren van de leverancier login.

GET /customer/list Sleutel + drager

Lijst of filter geautoriseerde klantinformatie.

GET /customer/me Sleutel + drager

Haal het ingelogde klantenprofiel op.

PATCH /customer/update Sleutel + drager

Update profiel, taal, type, e-mail of wachtwoord.

DELETE /customer/deleteaccount Sleutel + drager

Deactiveer het klantenaccount in de actieve winkel.

Eindpunten

Catalogus

Categorieën, producten, afbeeldingen, prijzen, voorraad, promoties en favorieten.

GET /fam1/list Sleutel + drager

Lijst van primaire categorieën.

POST /fam1/add Beheerder

Maak een primaire categorie.

PATCH /fam1/update Beheerder

Update een primaire categorie.

DELETE /fam1/delete Beheerder

Verberg een primaire categorie.

GET /fam2/list Sleutel + drager

Lijstsubcategorieën.

POST /fam2/add Beheerder

Maak een subcategorie aan.

PATCH /fam2/update Beheerder

Een subcategorie bijwerken.

DELETE /fam2/delete Beheerder

Verberg een subcategorie.

GET /product/list Sleutel + drager

Lijst en zoek producten met paginatie.

GET /product/image Ondertekende URL

Serveer een gesigneerde, cachebare productafbeelding.

POST /product/add Beheerder

Maak een product aan.

PATCH /product/update Beheerder

Update een product.

DELETE /product/delete Beheerder

Verberg een product.

POST /product/favoris Sleutel + drager

Voeg een product toe of verwijder deze uit favorieten.

GET /price/list Sleutel + drager

Lijst van prijzen die van toepassing zijn op de klantengroep.

GET /mark/list Sleutel + drager

Lijst beschikbare merken.

GET /size/list Sleutel + drager

Lijst beschikbare maten.

GET /libweb/list Sleutel + drager

Lijst van web referentie labels.

Eindpunten

Winkelwagen en bestellingen

Beheer de kar en bevestig een order atomair.

GET /admin/order/list Beheerder

Alle bevestigde leveranciersorders met klant, lijnen en paginatie ophalen.

GET /order/add Sleutel + drager

Ophalen of initialiseren van de huidige kar.

GET /order/list Sleutel + drager

Geef de kar en bestelgeschiedenis.

DELETE /order/delete Sleutel + drager

Wis en verwijder de huidige kar.

GET /order/total Sleutel + drager

Bereken kar subtotaal, BTW en totaal.

GET /order/count/line Sleutel + drager

Tel de lijnen in de kar.

POST /order/sendtomegawin Sleutel + drager

Bevestig de volgorde, vervullingmodus en adres.

POST /orderline/add Sleutel + drager

Voeg een product en hoeveelheid toe aan de winkelwagen.

GET /orderline/list Sleutel + drager

Ophalen van huidige karlijnen.

PATCH /orderline/update Sleutel + drager

Update een regelhoeveelheid.

DELETE /orderline/delete Sleutel + drager

Verwijder een lijn uit de kar.

Eindpunten

Documenten

Facturen, schattingen, orders en hun regels.

POST /document/add Sleutel + drager

Maak een document aan dat gekoppeld is aan de klant.

GET /document/list Sleutel + drager

Lijst of filterdocumenten.

PATCH /document/update Sleutel + drager

Een document bijwerken dat door GUID is geïdentificeerd.

DELETE /document/delete Sleutel + drager

Een document en de regels verwijderen.

POST /documentline/add Sleutel + drager

Voeg een regel toe en bereken het document opnieuw.

GET /documentline/list Sleutel + drager

Een document met al zijn regels ophalen.

PATCH /documentline/update Sleutel + drager

Update een lijn die door GUID is geïdentificeerd.

DELETE /documentline/delete Sleutel + drager

Verwijder een regel en bereken de totalen.

Eindpunten

Ondersteuning, kennisgevingen en integraties

Klantencommunicatie, ondersteuning en externe synchronisatie.

GET /support/ticket/list Sleutel + drager

Lijst met tickets beschikbaar voor de klant.

POST /support/ticket/create Sleutel + drager

Maak een supportverzoek.

GET /support/ticket/list/log_reply Sleutel + drager

Haal een ticket en de antwoorden.

GET /support/ticket/list/waiting_reply_by_support Sleutel + drager

Lijstverzoeken wachten op ondersteuning.

POST /support/ticket/reply/send Sleutel + drager

Antwoord op een ticket.

POST /admin/supplier/sendfeedbackfromapp Sleutel + drager

Stuur feedback naar de leverancier.

POST /admin/supplier/sendemailtosalesupport Sleutel + drager

Contacteer verkoopondersteuning.

GET /admin/notification/sendtomobile Sleutel + drager

Mobiele meldingen ophalen.

POST /admin/notification/setdelivery Sleutel + drager

Markeer een kennisgeving zoals deze is gedaan.

POST /woocommerce/menu/synchronisation Beheerder

Synchroniseer de categorieën WooCommerce.

POST /woocommerce/product/synchronisation Beheerder

Synchroniseer WooCommerce producten.

Kerncontracten

Gedetailleerde parameters

Parameters kunnen worden verzonden als JSON of, voor GET-routes, in de query string.

/auth/login+

NaamTypeVereistOmschrijving

logintekenreeksJa.

E-mail, klant login of login inclusief leverancierssuffix.

passwordtekenreeksJa.

Klantwachtwoord.

suppliertekenreeksNee

Leverancier achtervoegsel of sleutel wanneer niet opgenomen in de login.

/customer/add+

NaamTypeVereistOmschrijving

nomtekenreeksJa.

Achternaam van de klant.

prenomtekenreeksJa.

Voornaam van de klant.

emaile-mailJa.

E-mail uniek binnen de leverancier.

denominationtekenreeksNee

Bedrijfsnaam, optioneel.

passwordtekenreeksJa.

Minstens acht karakters.

languetekenreeksNee

Voorkeurstaal.

/product/list+

NaamTypeVereistOmschrijving

pagegeheel getalNee

Paginanummer, vanaf 1.

per_pagegeheel getalNee

Producten per pagina.

searchtekenreeksNee

Zoeken op code, naam of beschrijving.

category_idgeheel getalNee

Filter van primaire categorie.

subcategory_idgeheel getalNee

Subcategorie filter.

/product/add+

NaamTypeVereistOmschrijving

codetekenreeksJa.

Code uniek binnen de winkel.

nametekenreeksJa.

Naam weergegeven in de app.

descriptiontekenreeksNee

Gedetailleerde productbeschrijving.

base_pricedecimaalJa.

Verkoopprijs exclusief belasting volgens uw configuratie.

vat_ratedecimaalNee

BTW-tarief, bijvoorbeeld 21.

category_idgeheel getalNee

SellViaApp categorie identificatie.

external_keytekenreeksNee

Stabiele identificatie van uw ERP.

image_urlurlNee

HTTPS URL van de hoofdafbeelding.

activebooleaansNee

Controleert product zichtbaarheid.

/admin/order/list+

NaamTypeVereistOmschrijving

pagegeheel getalNee

Aangevraagde pagina, vanaf 1.

per_pagegeheel getalNee

Bestellingen per pagina, maximaal 100.

from_datedatumNee

Alleen retour orders vanaf deze datum.

guidtekenreeksNee

Haal één bevel van de GUID.

statustekenreeksNee

Filter beschikbaar afhankelijk van de opslagmodus: in afwachting, voorbereiding, gereed, geleverd of geannuleerd.

/order/sendtomegawin+

NaamTypeVereistOmschrijving

order_guiduuidNee

De cipier van de kar om te bevestigen.

delivery_modeenumJa.

pickup | delivery

delivery_addresstekenreeksNee

Vereist voor levering.

delivery_datedatumNee

JJJJ-MM-DD

delivery_commenttekenreeksNee

Gebruiksaanwijzing.

languagetekenreeksNee

Transactie e-mail taal.

/document/add+

NaamTypeVereistOmschrijving

doc_typetekenreeksJa.

invoice | estimate | purchase_order

customer_idgeheel getalNee

Compatibiliteit van de legacy; de geauthentiseerde klant heeft voorrang.

doc_numbertekenreeksJa.

Documentnummer.

doc_datedatumJa.

JJJJ-MM-DD

due_datedatumNee

JJJJ-MM-DD

payment_methodtekenreeksNee

Betalingswijze.

remarktekenreeksNee

Een opmerking in vrije vorm.

/documentline/add+

NaamTypeVereistOmschrijving

document_guiduuidJa.

Documenten.

texttekenreeksJa.

Lijnbeschrijving.

quantitydecimaalJa.

Hoeveelheid.

unit_pricedecimaalJa.

Eenheidsprijs exclusief BTW.

vat_ratedecimaalNee

BTW-tarief.

discount_percentagedecimaalNee

Percentage korting.

JSON

Responsenvelop

200 OK

{
  "success": true,
  "message": "OK",
  "data": {
    "items": []
  },
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 0
  }
}

Diagnostica

Gestructureerde fouten

Elke fout stelt een machineleesbare code, categorie, menselijk leesbaar bericht en, indien beschikbaar, een verzoekidentificatiecode bloot.

400Ongeldig verzoek

401Aanmelding vereist

403Toegang geweigerd

404Hulpbron of route niet gevonden

409Bedrijfsconflict

422Validatie mislukt

429Te veel verzoeken

5xxTechnisch incident

422 Onverwerkbare inhoud

{
  "success": false,
  "message": "The delivery address is required.",
  "data": null,
  "error": {
    "code": "DELIVERY_ADDRESS_REQUIRED",
    "category": "validation",
    "message": "The delivery address is required.",
    "details": {}
  }
}

Legacy documentatie

Legacy URL's blijven herkend

De nieuwe API accepteert varianten gepubliceerd op doc.sellviaapp.com zodat bestaande integraties blijven werken.

/api/document/*→/document/*

/user/add→/customer/add

/fam1/insert→/fam1/add

/product/insert→/product/add

/product/favorites→/product/favoris

/order/count→/order/count/line

/CUSTOMER/LIST→/customer/list

Verificatie voltooid

Elke route die in de legacy documentatie wordt gepubliceerd heeft nu een eigen route of een compatibiliteitsalias.

Voer uw app en ophalen van bestellingen via de API.

Een eenvoudige tweeweg datastroom

Uw ERP

API SellViaApp

Mobiele app

Uw orders

Sluit uw systeem in drie stappen aan

Haal je referenties

Geef de catalogus

Bevelen ophalen

Afzonderlijke referenties voor elk gebruik

X-API-Key

Autorisatie: drager

X-Admin-Token

Authenticatie

Leveranciers en merken

Klanten

Catalogus

Winkelwagen en bestellingen

Documenten

Ondersteuning, kennisgevingen en integraties

Gedetailleerde parameters

Responsenvelop

Gestructureerde fouten

Legacy URL's blijven herkend