DoliSharp 8.0.6

DoliSharp

.NET libraries for the Dolibarr REST API, plus an optional Shopify ↔ Dolibarr connector (orders via webhooks, stock sync).

Target framework: .NET 8

Features

DoliSharp

• IProductService — list products, product stock
• IOrderService — CRUD-ish order flow (create, validate, draft, invoice, deliver, reopen, delete)
• IThirdPartyService — list / get / create / update third parties
• Fluent filters (GetProductFilter, …) for Dolibarr query params and SQL filters
• Newtonsoft-based serialization tuned for Dolibarr payloads
• Results as HttpResponseResult<T> (wraps ErrorOr)

DoliSharp.Shopify

• Webhook topics: orders/create, orders/updated, orders/cancelled
• Maps Shopify customers/orders to Dolibarr third parties and orders
• ISyncStockService — push Dolibarr warehouse stock to Shopify inventory levels
• FulfillShopifyOrderCommand — mark a Shopify order fulfilled (fulfillment orders)

Installation

dotnet add package DoliSharp
dotnet add package DoliSharp.Shopify   # optional connector

Or via PackageReference:

<ItemGroup>
  <PackageReference Include="DoliSharp" Version="0.1.0" />
  
  <PackageReference Include="DoliSharp.Shopify" Version="0.1.0" />
</ItemGroup>

Quick start — Dolibarr SDK

using DoliSharp;
using DoliSharp.Credentials;
using DoliSharp.Filters;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();

services.AddDoliSharp(new DolibarrCredentials(
    Url: "https://your-dolibarr.example.com",
    Token: "YOUR_DOLAPIKEY"
));

var provider = services.BuildServiceProvider();
var products = provider.GetRequiredService<DoliSharp.Services.Products.IProductService>();

var result = await products.GetProducts(
    new GetProductFilter().WithLimit(50).FilterOnProductRef("SKU-001", "SKU-002")
);

if (result.IsError)
{
    // result.Errors / result.FirstError
    return;
}

foreach (var product in result.Value)
{
    Console.WriteLine($"{product.Ref} — {product.Label}");
}

You can also construct services directly:

var orders = new OrderService(new DolibarrCredentials(url, token));
var created = await orders.CreateOrderAsync(order);

Quick start — Shopify connector

Requires DoliSharp registered as well (order / product / third-party services).

services.AddDoliSharp(new DolibarrCredentials(dolibarrUrl, dolibarrToken));
services.AddShopifyConnector(shopifyUrl: "https://your-shop.myshopify.com", shopAccessToken: "shpat_...");

Process a webhook

Forward the raw body and Shopify headers to MediatR:

using DoliSharp.Shopify.Webhooks.Commands;
using DoliSharp.Shopify.Webhooks.Domain;
using MediatR;

var webhook = new WebhookRequest(
    Id: someId,
    Body: rawJsonBody,
    Headers: headerDictionary // includes X-Shopify-Topic, etc.
);

ErrorOr<Success> outcome = await sender.Send(new ProcessShopifyWebhookCommand(webhook));

Supported topics (see ShopifyWebhookTopics):

Sync stock Dolibarr → Shopify

using DoliSharp.Shopify.Stock;
using DoliSharp.Shopify.Stock.Abstractions;

var sync = provider.GetRequiredService<ISyncStockService>();

var request = new StockSyncRequest()
    .AddStockSyncWarehouse(dolibarWarehouseId: 1, shopifyWarehouseId: 123456789);

var movement = await sync.SynchroniseDolibarrWithShopifyAsync(request);

Solution layout

src/
  DoliSharp/                 # Dolibarr SDK  → PackageId: DoliSharp
  DoliSharp.Shopify/         # Shopify connector → PackageId: DoliSharp.Shopify
  DoliSharp.Tests/
  DoliSharp.Shopify.Tests/

Error handling

• Prefer ErrorOr<T> / HttpResponseResult<T> over exceptions for expected failures.
• Shared codes live in DoliSharp.Domain.DomainErrors and DoliSharp.Shopify.Domain.DomainErrors.

if (result.IsError)
    return result.FirstError.Description;

Development

dotnet restore
dotnet build
dotnet test

Format C# with CSharpier (config at repo root):

dotnet tool restore
dotnet tool run csharpier format src

License

Licensed under the Apache License 2.0.