Yuki API-koppeling (algemeen): verschil tussen versies

Versie van 25 apr 2019 14:51

De API heeft drie webservices [1]:

Ik denk dat je meer kunt dan alleen verkoopfacturen aanmaken (dat was misschien alleen vermeld voor de home page) [2]:

Financiële rapportages ophalen zoals de openstaande posten en het huidige saldibalans
Aanmaken van verkoopfacturen
Aanmaken van memoriaalboekingen
Ophalen en aanleveren van documenten
Zoeken in het archief
Ophalen van contact gegevens
Bijwerken of aanmaken van contact gegevens
Importeren van kastransacties
Aanmaken actieve en proefdomeinen
Ophalen en aanmaken gebruikers in domein.

Ophalen financiële rapportages voor de accountant. Bedoeld voor data vanuit Yuki, niet andersom
http://help.yuki.nl/documents/homepage/startpagina-yuki-api-documentatie/accounting-webservice

Ik ga uit van deze situatie:

Sales webservice → Verkoopfacturen, ProcessSalesInvoices [3]
SOAP, PHP
Verbindingsbeveiliging: TLS 1.2 of hoger [4]
Je hebt toegangsrechten nodig op het betreffende domein [5] - Details onbekend

Je hebt toegangsrechten nodig op het betreffende domein [6] - Ik denk dat de rol Verkoop voldoende is. Wat je nodig hebt:

Met deze service (?) verkrijg je een session id op basis van een geldige gebruikersnaam en wachtwoord

Het werkt met m'n gebruikelijk Yuki-credentials binnen deze testomgeving: https://api.yukiworks.nl/ws/Sales.asmx?op=AuthenticateByUserName. Replies bij verschillende situaties:

Geldige gebruikersnaam & geldig wachtwoord


<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://www.theyukicompany.com/">800a02a5-b4e3-430c-bac8-70a0a2c70249</string>

Geldige gebruikersnaam - Ongeldig wachtwoord

Invalid password

Ongeldige gebruikersnaam - Wachtwoord dus niet relevant

Unknown user name

@@ Regel 50: / Regel 50: @@
 == Sales Web Service - AuthenticaByUsername ==
-Met deze ''service'' or ''method''
+Met deze ''service'' (?) verkrijg je een ''session id'' op basis van een geldige ''gebruikersnaam'' en ''wachtwoord''
-=== Testomgeving ===
+=== Binnen de testomgeving ===
-Als ik op de "API-pagina" https://api.yukiworks.nl/ws/Sales.asmx?op=AuthenticateByUserName inlog met m'n gewone gebruikersgegevens, krijg ik als ''reply''
+Het werkt met m'n gebruikelijk Yuki-credentials binnen deze testomgeving: https://api.yukiworks.nl/ws/Sales.asmx?op=AuthenticateByUserName. Replies bij verschillende situaties:
+''' Geldige gebruikersnaam & geldig wachtwoord '''
 <pre>
@@ Regel 62: / Regel 64: @@
 </pre>
-Als ik inlog met een foutief wachtwoord maar met de juiste gebruikersnaam, krijg ik
+''' Geldige gebruikersnaam - Ongeldig wachtwoord '''
 <pre>
@@ Regel 68: / Regel 70: @@
 </pre>
-Als in inlog met een foutieve inlognaam, krijg ik
+''' Ongeldige gebruikersnaam - Wachtwoord dus niet relevant '''
 <pre>