Laravel Moloni

MOLONI_CLIENT_ID=your-client-id
MOLONI_CLIENT_SECRET=your-client-secret
MOLONI_USERNAME=your-username
MOLONI_PASSWORD=your-password
MOLONI_COMPANY_ID=your-company-id

# Opcional. Default: producao. Sobrepor para apontar a sandbox.
# Producao: https://api.moloni.pt/v1/
# Sandbox:  https://api.moloni.pt/sandbox/
MOLONI_BASE_URL=https://api.moloni.pt/v1/

$companyId = config('moloni.company_id');

// Listar todos
$products = Moloni::products()->getAll($companyId);

// Pesquisar por referencia
$product = Moloni::products()->getByReference($companyId, 'PROD-001');

use DigitaldevLx\LaravelMoloni\DataTransferObjects\Product as ProductDto;
use DigitaldevLx\LaravelMoloni\Enums\ProductType;

$dto = new ProductDto(
    name: 'Widget',
    reference: 'PROD-001',
    type: ProductType::Product,
    categoryId: 1,
    unitId: 1,
    price: 29.99,
);

$product = Moloni::products()->insert($companyId, $dto);

$companyId = config('moloni.company_id');

$taxes              = Moloni::taxes()->getAll($companyId);
$taxExemptions      = Moloni::taxExemptions()->getAll();
$paymentMethods     = Moloni::paymentMethods()->getAll($companyId);
$documentSets       = Moloni::documentSets()->getAll($companyId);
$warehouses         = Moloni::warehouses()->getAll($companyId);
$units              = Moloni::measurementUnits()->getAll($companyId);
$maturityDates      = Moloni::maturityDates()->getAll($companyId);
$deliveryMethods    = Moloni::deliveryMethods()->getAll($companyId);
$bankAccounts       = Moloni::bankAccounts()->getAll($companyId);
$caeCodes           = Moloni::caeCodes()->getAll($companyId);
$deductions         = Moloni::deductions()->getAll($companyId);
$idTemplates        = Moloni::identificationTemplates()->getAll($companyId);

$products           = Moloni::products()->getAll($companyId);
$categories         = Moloni::productCategories()->getAll($companyId);
$stocks             = Moloni::productStocks()->getAll($companyId);
$properties         = Moloni::productProperties()->getAll($companyId);
$priceClasses       = Moloni::priceClasses()->getAll($companyId);

$customers              = Moloni::customers()->getAll($companyId);
$customerAltAddresses   = Moloni::customerAlternateAddresses()->getAll($companyId);
$suppliers              = Moloni::suppliers()->getAll($companyId);
$salesmen               = Moloni::salesmen()->getAll($companyId);

$countries          = Moloni::countries()->getAll();
$fiscalZones        = Moloni::fiscalZones()->getAll($countryId);
$languages          = Moloni::languages()->getAll();
$currencies         = Moloni::currencies()->getAll();
$currencyExchange   = Moloni::currencyExchange()->get($from, $to);
$documentModels     = Moloni::documentModels()->getAll();
$multibancoGateways = Moloni::multibancoGateways()->getAll();

// v2.0 — perfil e conta
$profile      = Moloni::myProfile()->get();
$subscription = Moloni::subscription()->get();
$users        = Moloni::users()->getAll($companyId);

// v2.0 — auxiliares
$salesmen = Moloni::salesmen()->getAll($companyId);
$vehicles = Moloni::vehicles()->getAll($companyId);

// v2.0 — empresa
$slug = Moloni::companies()->freeSlug($companyId, 'my-slug');

// v2.1 — ciclo de venda alargado
$paymentReturns      = Moloni::paymentReturns()->getAll($companyId);
$customerReturns     = Moloni::customerReturnNotes()->getAll($companyId);
$internalDocs        = Moloni::internalDocuments()->getAll($companyId);
$globalGuides        = Moloni::globalGuides()->getAll($companyId);
$ownAssetsGuides     = Moloni::ownAssetsMovementGuides()->getAll($companyId);

// v2.1 — ciclo de fornecedor
$supplierCreditNotes      = Moloni::supplierCreditNotes()->getAll($companyId);
$supplierDebitNotes       = Moloni::supplierDebitNotes()->getAll($companyId);
$supplierReturnNotes      = Moloni::supplierReturnNotes()->getAll($companyId);
$supplierReceipts         = Moloni::supplierReceipts()->getAll($companyId);
$supplierWarranty         = Moloni::supplierWarrantyRequests()->getAll($companyId);
$supplierSimplifiedInv    = Moloni::supplierSimplifiedInvoices()->getAll($companyId);
$supplierPurchaseOrders   = Moloni::supplierPurchaseOrders()->getAll($companyId);

use DigitaldevLx\LaravelMoloni\Exceptions\MoloniException;
use DigitaldevLx\LaravelMoloni\Exceptions\AuthenticationException;
use DigitaldevLx\LaravelMoloni\Exceptions\ValidationException;
use DigitaldevLx\LaravelMoloni\Exceptions\RateLimitException;

try {
    $invoice = Moloni::invoices()->insert($companyId, $data);
} catch (AuthenticationException $e) {
    // $e->authError        - AuthError enum
    // $e->errorDescription - Descricao do erro
    Log::error('Moloni auth failed', ['error' => $e->authError]);
} catch (ValidationException $e) {
    // $e->errors             - Array de erros
    // $e->getFieldErrors()   - Erros por campo
    // $e->hasFieldError('vat') - Verificar campo especifico
    return back()->withErrors($e->getFieldErrors());
} catch (RateLimitException $e) {
    // Retry apos espera
    dispatch(fn () => retry(...))->delay(now()->addMinutes(1));
} catch (MoloniException $e) {
    // Erro generico da API
    Log::error('Moloni error', ['message' => $e->getMessage()]);
}

use DigitaldevLx\LaravelMoloni\Enums\ValidationErrorCode;

try {
    $customer = Moloni::customers()->insert($companyId, $data);
} catch (ValidationException $e) {
    // Array completo de erros: [['code' => int, 'field' => string, 'description' => string], ...]
    $errors = $e->errors;

    // Erros organizados por campo
    $fieldErrors = $e->getFieldErrors();
    // ['vat' => 'NIF portugues invalido', 'email' => 'Endereco de email invalido']

    // Verificar se um campo especifico falhou
    if ($e->hasFieldError('vat')) {
        // Tratar erro de NIF
    }
}

# Testes
vendor/bin/pest

# Analise estatica
vendor/bin/phpstan analyse

# Formatacao de codigo
vendor/bin/pint

use Illuminate\Support\Facades\Http;
use DigitaldevLx\LaravelMoloni\Facades\Moloni;

it('creates an invoice for the order', function () {
    Http::fake([
        'api.moloni.pt/sandbox/grant/*' => Http::response([
            'access_token'  => 'fake-token',
            'refresh_token' => 'fake-refresh',
            'expires_in'    => 3600,
        ]),
        'api.moloni.pt/sandbox/invoices/insert/*' => Http::response([
            'valid'       => 1,
            'document_id' => 999,
        ]),
    ]);

    $order = Order::factory()->create();
    CreateInvoiceJob::dispatchSync($order);

    expect($order->moloniDocuments)->toHaveCount(1);
});