Yuki API-koppeling (algemeen)

Webservices

De API heeft drie webservices [1]:

Sales Webservice

• Aanmaken van verkoopfacturen (bv. koppeling webshop)
• http://help.yuki.nl/documents/homepage/startpagina-yuki-api-documentatie/sales-webservice
• SOAP & XML
• Testomgeving: https://api.yukiworks.nl/ws/Sales.asmx

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.

Digitaal Archief

• Aanleveren van niet-financiële documenten
• Gaat via upload

Accounting webservice

• 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

Context

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

Toegangsrechten

Je hebt toegangsrechten nodig op het betreffende domein [6] - Ik denk dat de rol Verkoop voldoende is. Ik vermoed dat verschillende manieren zijn om in te loggen, maar details zijn me nog niet bekend.

Sales Web Service - AuthenticaByUsername

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

Binnen de testomgeving

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

Zie ook

• SOAP

Bronnen

• https://www.yuki.nl/webservice-api/ - Overzicht met 3 webservices
• http://help.yuki.nl/documents/homepage/startpagina-yuki-api-documentatie - Startpagina API-documentatie - Inclusief programmeervoorbeelden
• http://help.yuki.nl/documents/homepage/startpagina-yuki-api-documentatie/sales-webservice - Startpagina Sales-Webservice
• http://help.yuki.nl/documents/homepage/startpagina-yuki-api-documentatie/sales-webservice/sales---functionele-beschrijving-verkoopfacturen-xml
• http://help.yuki.nl/documents/development/concept-documentatie/enkele-aandachtspunten-api
• https://www.yukiworks.nl/schemas/SalesInvoices.xsd - Complete XML-schema voor facturen
• https://www.duopact.nl/yuki-koppelingen - Zoiets dus