Golang Receipt OCR API for Financial Automation

// 💰 Save hours of development. Get 200 free credits instantly:
// 👉 https://structocr.com/register

package main

import (
	"bytes"
	"encoding/base64"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

// Define structs for safe JSON unmarshaling
type ApiResponse struct {
	Success bool        `json:"success"`
	Data    ReceiptData `json:"data"`
	Error   string      `json:"error"`
}

type ReceiptData struct {
	ResponseVersion int        `json:"response_version"`
	MerchantName    string     `json:"merchant_name"`
	Date            string     `json:"date"`
	Currency        string     `json:"currency"`
	TotalAmount     *float64   `json:"total_amount"`
	TaxAmount       *float64   `json:"tax_amount"`
	Items           []LineItem `json:"items"`
	Status          string     `json:"status"`
}

type LineItem struct {
	Name     *string  `json:"name"`
	Quantity *float64 `json:"quantity"`
	Price    *string  `json:"price"`
}

func main() {
	apiKey := "YOUR_API_KEY" // Replace with your StructOCR API key
	imagePath := "./lunch_receipt.jpg" // Path to your test image

	// 1. Read and base64 encode the image
	imgBytes, err := os.ReadFile(imagePath)
	if err != nil {
		fmt.Println("Error reading file:", err)
		os.Exit(1)
	}
	imgBase64 := base64.StdEncoding.EncodeToString(imgBytes)

	// 2. Prepare JSON payload
	payload := map[string]string{"img": imgBase64}
	payloadBytes, err := json.Marshal(payload)
	if err != nil {
		fmt.Println("Error marshaling payload:", err)
		os.Exit(1)
	}

	// 3. Create HTTP POST request targeting the Receipt endpoint
	req, err := http.NewRequest("POST", "https://api.structocr.com/v1/receipt", bytes.NewBuffer(payloadBytes))
	if err != nil {
		fmt.Println("Error creating request:", err)
		os.Exit(1)
	}

	req.Header.Set("x-api-key", apiKey)
	req.Header.Set("Content-Type", "application/json")

	// 4. Execute the request
	client := &http.Client{}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println("Error executing request:", err)
		os.Exit(1)
	}
	defer res.Body.Close()

	// 5. Parse the structured response
	bodyBytes, _ := io.ReadAll(res.Body)
	var response ApiResponse
	if err := json.Unmarshal(bodyBytes, &response); err != nil {
		fmt.Println("Error decoding JSON response:", err)
		os.Exit(1)
	}

	// 6. Output the parsed data
	if response.Success {
		fmt.Println("✅ Receipt Parsed Successfully!")
		fmt.Printf("Merchant: %s\n", response.Data.MerchantName)
		fmt.Printf("Date: %s\n", response.Data.Date)
		fmt.Printf("Total: %v %s\n", response.Data.TotalAmount, response.Data.Currency)
		fmt.Printf("Status: %s\n", response.Data.Status)
		
		fmt.Println("\n--- Extracted Line Items ---")
		for _, item := range response.Data.Items {
			fmt.Printf("- %v (Qty: %v) = %v\n", item.Name, item.Quantity, item.Price)
		}
	} else {
		fmt.Println("❌ Extraction Failed:", response.Error)
	}
}