ebarimtv3

README

🧾 ebarimt-pos3-go

Ebarimt POS 3.0 Golang Implementation SDK - A comprehensive Go library for integrating with the Ebarimt POS 3.0 system.

✨ Features

• 🚀 Complete POS 3.0 API implementation
• 🛡️ Type-safe Go structures for all API requests and responses
• ⚡ Comprehensive error handling
• 🔐 Built-in authentication and security features
• ✅ Extensive test coverage
• 💾 GORM integration for database operations

📦 Installation

go get github.com/batorgil-it/ebarimt-pos3-go

🚀 Quick Start

package main

import (
    "github.com/batorgil-it/ebarimt-pos3-go"
    "gorm.io/gorm"
)

func main() {
    // Initialize the client with required parameters
    client := ebarimtv3.New(ebarimtv3.Input{
        Endpoint:    "https://example.ebarimt.mn",
        PosNo:       "YOUR_POS_NUMBER",
        MerchantTin: "YOUR_MERCHANT_TIN",
        // Optional parameters
        DB:       nil, // Your GORM DB instance if you want to store receipts
        MailHost: "",  // SMTP host for email notifications
        MailPort: 0,   // SMTP port for email notifications
    })

    // Create a receipt
    response, err := client.Create(models.CreateInputModel{
        // Add your receipt details here
    })
    if err != nil {
        // Handle error
    }
    // Use the response
    fmt.Printf("Receipt created: %+v\n", response)
}

📚 Documentation

For detailed documentation and examples, please visit our documentation.

📁 Project Structure

ebarimt-pos3-go/
├── 📂 constants/     # Constant definitions
├── 📂 files/        # File handling utilities
├── 📂 pos3/         # Core POS 3.0 implementation
├── 📂 services/     # Service layer implementations
├── 📂 structs/      # Data structures
├── 📂 tests/        # Test files
└── 📂 utils/        # Utility functions

⚙️ Requirements

• 🔷 Go 1.23.5 or higher
• 🔷 GORM v1.25.12
• 🔷 Other dependencies as specified in go.mod

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. 🍴 Fork the repository
2. 🌿 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 📤 Push to the branch (git push origin feature/AmazingFeature)
5. 🔄 Open a Pull Request

🧪 Testing

Run the test suite:

go test ./...

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Support

For support, please open an issue in the GitHub repository or contact our support team.

🙏 Acknowledgments

• 👥 Thanks to all contributors who have helped shape this project
• 🌟 Special thanks to the Ebarimt team for their support and documentation

🔒 Security

For security concerns, please email security@techpartners.asia or open a security advisory in the GitHub repository.

Documentation

Index

• type EbarimtClient
  • func New(input Input) *EbarimtClient
  • func (e *EbarimtClient) CalculateTotals(items []models.CreateItemInputModel) (*models.CalculateTotalsOutputModel, error)
  • func (e *EbarimtClient) Create(input models.CreateInputModel) (*structs.ReceiptResponse, error)
• type Input

Types

type EbarimtClient

type EbarimtClient struct {
	pos3.Pos3

	// * NOTE * : Optional & Integration To the Third Party
	DB           *gorm.DB
	MailHost     string
	MailPort     string
	MailFrom     string
	MailSubject  string
	MailPassword string
	MailUser     string
	TemplatePath string
}

func New

func New(input Input) *EbarimtClient

func (*EbarimtClient) CalculateTotals

func (e *EbarimtClient) CalculateTotals(items []models.CreateItemInputModel) (*models.CalculateTotalsOutputModel, error)

func (*EbarimtClient) Create

func (e *EbarimtClient) Create(input models.CreateInputModel) (*structs.ReceiptResponse, error)

type Input

type Input struct {
	Endpoint    string
	PosNo       string
	MerchantTin string
	IsDev       bool

	// * NOTE * : Optional & Integration To the Third Party
	DB           *gorm.DB // Хоосон байж болно. Хэрвээ байвал, database дээр хадгална автоматаар
	MailHost     string
	MailPort     string
	MailFrom     string
	MailSubject  string
	MailPassword string
	MailUser     string
	TemplatePath string
}