Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bubblydoo/exact-xml-uploader
Upload XML invoices to Exact Online with your CLI
https://github.com/bubblydoo/exact-xml-uploader
exactonline
Last synced: 8 days ago
JSON representation
Upload XML invoices to Exact Online with your CLI
- Host: GitHub
- URL: https://github.com/bubblydoo/exact-xml-uploader
- Owner: bubblydoo
- License: mit
- Created: 2022-10-01T15:01:07.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-19T15:22:47.000Z (about 2 months ago)
- Last Synced: 2024-12-24T21:33:53.131Z (15 days ago)
- Topics: exactonline
- Language: TypeScript
- Homepage:
- Size: 200 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Exact XML Uploader
This is a simple tool to upload XML files to Exact Online (uses the XML Import functionality). It is written in Typescript and uses Puppeteer.
## Usage
```bash
npx env-cmd -f .env -- npm run upload -- ../folder-with-xmls --otp 123456
```
You need to make some of these environment variables available (e.g. in a `.env` file):
```
EXACT_DIVISION="123456" # you can find this in the url of Exact Online after logging in
# Auto login mode
USERNAME="Username" # your username
PASSWORD="Password" # your password
OTP_URI="otpauth://totp/SECRET" # to auto-generate OTP code
# Manual login mode
LOGIN_MODE=manual # if logging in through external URL
LOGIN_URL="https://start.exactonline.be/sso?connection=PROVIDER&_Division_=123456" # URL to log in
```
After upload, you can find error logs and screenshots in the `tmp` folder.
If you just want to login:
```bash
npx env-cmd -f .env -- npm run login
```
After logging in, you can turn on headless mode to upload files.
```bash
npx env-cmd -f .env -- npm run upload -- ../folder-with-xmls --headless
```
## Troubleshooting
#### `Topic [GLTransactions] Property 'VATCode' of business component 'GLTransactionVATLine' is mandatory.`
This means the VAT code doesn't exist in Exact Online.
#### `Topic [GLTransactions] Not allowed: Currency`
The journal doesn't support the currency.