Yuki API-koppeling (algemeen): verschil tussen versies
Naar navigatie springen
Naar zoeken springen
Regel 49: | Regel 49: | ||
== Sales Web Service - AuthenticaByUsername == | == Sales Web Service - AuthenticaByUsername == | ||
+ | |||
+ | Met deze ''service'' or ''method'' | ||
=== Testomgeving === | === Testomgeving === |
Versie van 25 apr 2019 14:46
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. Wat je nodig hebt:
- ?
Sales Web Service - AuthenticaByUsername
Met deze service or method
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
<?xml version="1.0" encoding="utf-8"?> <string xmlns="http://www.theyukicompany.com/">800a02a5-b4e3-430c-bac8-70a0a2c70249</string>
Als ik inlog met een foutief wachtwoord maar met de juiste gebruikersnaam, krijg ik
Invalid password
Als in inlog met een foutieve inlognaam, krijg ik
Unknown user name
Script vanaf laptop
Zie ook
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