Vantroute.Sdk 1.0.1

Vantroute SDK for .NET

Official .NET SDK for the Vantroute prescription routing API. Supports .NET Framework 4.6.1+ (netstandard2.0), .NET 6, and .NET 8.

Installation

dotnet add package Vantroute.Sdk

Quick Start

1. Register via Dependency Injection (ASP.NET Core)

builder.Services.AddVantroute(opts =>
{
    opts.BaseUrl = "https://api.vantroute.com";
    opts.ClientId = builder.Configuration["Vantroute:ClientId"]!;
    opts.ClientSecret = builder.Configuration["Vantroute:ClientSecret"]!;
});

Then inject IVantrouteClient into your services. Authentication is automatic.

2. Submit a Prescription (Typed Model)

public class PrescriptionService(IVantrouteClient client)
{
    public async Task SubmitAsync()
    {
        var result = await client.SubmitScriptAsync(new VantroutePrescription
        {
            Patient = new PatientInfo
            {
                FirstName = "Jane",
                LastName = "Doe",
                DateOfBirth = "1985-06-15",
                Phone = "5551234567",
                Address = new AddressInfo
                {
                    Street1 = "123 Main St",
                    City = "Austin",
                    State = "TX",
                    Zip = "78701"
                }
            },
            Prescriber = new PrescriberInfo
            {
                FirstName = "John",
                LastName = "Smith",
                Npi = "1234567890",
                Phone = "5559876543"
            },
            Prescription = new PrescriptionInfo
            {
                DrugName = "Amoxicillin 500mg Capsule",
                Quantity = 30,
                Refills = 2,
                DaysSupply = 10,
                DateWritten = "2026-03-25",
                Directions = "Take 1 capsule by mouth 3 times daily"
            }
        });

        Console.WriteLine($"Accepted: {result.CorrelationId}");
    }
}

3. Submit a Raw JSON Payload

For providers with their own payload format and server-side mapping configured:

var result = await client.SubmitScriptAsync(rawJsonString, new SubmitScriptOptions
{
    IdempotencyKey = "order-12345"
});

4. Receive Webhooks

Register a webhook endpoint to receive prescription status updates from Vantroute:

app.MapPost("/webhook/vantroute", async (HttpContext ctx, IWebhookReceiver receiver) =>
{
    using var reader = new StreamReader(ctx.Request.Body);
    var body = await reader.ReadToEndAsync();
    var signature = ctx.Request.Headers["X-Vantroute-Signature"].ToString();

    if (!receiver.VerifySignature(body, signature, signingSecret))
        return Results.Unauthorized();

    var evt = receiver.ParseEvent(body);
    // Handle status update: evt.CorrelationId, evt.Status, evt.EventType
    return Results.Ok();
});

API Reference

Examples

See the examples/BasicUsage project for a complete ASP.NET Core sample with DI, typed submission, raw submission, and webhook receiver.

License

MIT