Download the PHP package rafapaulino/omiephpsdk without Composer
On this page you can find all versions of the php package rafapaulino/omiephpsdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rafapaulino/omiephpsdk
More information about rafapaulino/omiephpsdk
Files in rafapaulino/omiephpsdk
Package omiephpsdk
Short Description Biblioteca PHP para o uso com a api da OMIE
License MIT
Informations about the package omiephpsdk
Biblioteca de Integração com a Omie
A url para realizar os testes na api da Omie é essa: https://app.omie.com.br/developer/
Biblioteca PHP para facilitar integração com a API da Omie.
Este projeto ainda está em construção, mas já tem uma base pronta para:
- carregar configurações por
.env - resolver configuração para Laravel e standalone
- definir contratos de clientes seguindo SOLID
- executar testes com Pest
Para quem é este projeto?
Para desenvolvedores iniciantes e intermediários que querem organizar uma integração com a Omie de forma simples e escalável.
Requisitos
Antes de começar, você precisa ter instalado:
- PHP 8.4+ (recomendado)
- Composer
Instalação
- Entre na pasta do projeto.
- Instale as dependências:
Configuração do ambiente (.env)
Este projeto lê variáveis de ambiente para montar a configuração.
- Crie o arquivo
.envna raiz do projeto (ou copie de.env.example). - Preencha os valores:
O que cada variável significa?
OMIE_API: URL base da API da Omie.OMIE_APP_KEY: sua chave da aplicação na Omie.OMIE_APP_SECRET: seu segredo da aplicação na Omie.
Uso com Laravel
O pacote suporta auto-discovery do provider via Composer.
-
Adicione as variáveis no
.envda aplicação Laravel: -
Publique a configuração do pacote:
- Injete as interfaces diretamente no container do Laravel:
Arquivo de configuração publicado: config/omie.php.
Como obter as configurações no código
A classe Config resolve automaticamente a configuração:
- em Laravel, lê
config('omie') - em standalone, carrega
.enve usasrc/config.php
Arquivo: src/Config/Config.php
Exemplo:
Saída esperada (exemplo):
ConfigSingleton continua disponível por retrocompatibilidade.
Estrutura de contratos (SOLID)
As interfaces de clientes foram separadas por responsabilidade (Interface Segregation Principle).
Pasta: src/Clients/Contracts
Interfaces disponíveis:
CreatesClientsInterface(createClient)RetrievesClientsInterface(getClient)UpdatesClientsInterface(updateClient)DeletesClientsInterface(deleteClient)ListsClientsInterface(listClients)ClientServiceInterface(agrega todas as interfaces acima)
Isso permite implementar apenas o que sua classe realmente precisa.
Contratos de users:
ListsUsersInterface(listUsers)UserServiceInterface(agrega as interfaces de users)
Contratos de vendedores:
CreatesSellersInterface(createSeller)SellerServiceInterface(agrega as interfaces de vendedores)
Contratos de produtos:
ListsProductsInterface(listProducts)ProductServiceInterface(agrega as interfaces de produtos)
Contratos de contas correntes:
ListsCurrentAccountsInterface(listCurrentAccounts)CurrentAccountServiceInterface(agrega as interfaces de contas correntes)
Contratos de CFOP:
ListsCfopInterface(listCfop)CfopServiceInterface(agrega as interfaces de CFOP)
Contratos de categorias:
ListsCategoriesInterface(listCategories)CategoryServiceInterface(agrega as interfaces de categorias)
Contratos de formas de pagamento:
ListsPaymentMethodsInterface(listPaymentMethods)PaymentMethodServiceInterface(agrega as interfaces de formas de pagamento)
Service de Clientes (OmieClientService)
A implementação atual do serviço de clientes está em src/Clients/OmieClientService.php.
Métodos já implementados:
createClient(array $payload): arraylistClients(array $filters = []): arraygetClient(int|string $clientId): arrayupdateClient(int|string $clientId, array $payload): arraydeleteClient(int|string $clientId): array
Exemplo de uso
No updateClient, se o payload não incluir codigo_cliente_omie ou codigo_cliente_integracao,
o método usa o valor de $clientId como codigo_cliente_integracao.
Filtros do listClients
Por padrão, o método envia:
pagina = 1registros_por_pagina = 50apenas_importado_api = 'N'
Você pode sobrescrever esses valores passando o array $filters.
Service de Users (OmieUserService)
A implementação atual do serviço de users está em src/Users/OmieUserService.php.
Métodos já implementados:
listUsers(array $filters = []): array
Exemplo de uso
Filtros do listUsers
Por padrão, o método envia:
pagina = 1registros_por_pagina = 20
Você pode sobrescrever esses valores passando o array $filters.
Service de Vendedores (OmieSellerService)
A implementação atual do serviço de vendedores está em src/Sellers/OmieSellerService.php.
Métodos já implementados:
createSeller(array $payload): array
Exemplo de uso
Service de Produtos (OmieProductService)
A implementação atual do serviço de produtos está em src/Products/OmieProductService.php.
Métodos já implementados:
listProducts(array $filters = []): array
Exemplo de uso
Filtros do listProducts
Por padrão, o método envia:
pagina = 1registros_por_pagina = 50apenas_importado_api = 'N'filtrar_apenas_omiepdv = 'N'
Você pode sobrescrever esses valores passando o array $filters.
Service de Contas Correntes (OmieCurrentAccountService)
A implementação atual do serviço de contas correntes está em src/CurrentAccount/OmieCurrentAccountService.php.
Métodos já implementados:
listCurrentAccounts(array $filters = []): array
Exemplo de uso
Filtros do listCurrentAccounts
Por padrão, o método envia:
pagina = 1registros_por_pagina = 100apenas_importado_api = 'N'
Você pode sobrescrever esses valores passando o array $filters.
Service de CFOP (OmieCfopService)
A implementação atual do serviço de CFOP está em src/CFOP/OmieCfopService.php.
Métodos já implementados:
listCfop(array $filters = []): array
Exemplo de uso
Filtros do listCfop
Por padrão, o método envia:
pagina = 1registros_por_pagina = 50
Você pode sobrescrever esses valores passando o array $filters.
Service de Categorias (OmieCategoryService)
A implementação atual do serviço de categorias está em src/Categories/OmieCategoryService.php.
Métodos já implementados:
listCategories(array $filters = []): array
Exemplo de uso
Filtros do listCategories
Por padrão, o método envia:
pagina = 1registros_por_pagina = 50
Você pode sobrescrever esses valores passando o array $filters.
Service de Formas de Pagamento (OmiePaymentMethodService)
A implementação atual do serviço de formas de pagamento está em src/PaymentMethods/OmiePaymentMethodService.php.
Métodos já implementados:
listPaymentMethods(array $filters = []): array
Exemplo de uso
Filtros do listPaymentMethods
Por padrão, o método envia:
pagina = 1registros_por_pagina = 50
Você pode sobrescrever esses valores passando o array $filters.
Service de Etapas de Faturamento (OmieBillingStepService)
A implementação atual do serviço de etapas de faturamento está em src/BillingSteps/OmieBillingStepService.php.
Métodos já implementados:
listBillingSteps(array $filters = []): array
Exemplo de uso
Filtros do listBillingSteps
Por padrão, o método envia:
pagina = 1registros_por_pagina = 20
Você pode sobrescrever esses valores passando o array $filters.
Service de Ordens de Serviço (OmieServiceOrderService)
A implementação atual do serviço de ordens de serviço está em src/ServiceOrders/OmieServiceOrderService.php.
Métodos já implementados:
createServiceOrder(array $payload): array
Exemplo de uso
Service de Serviços (OmieServiceService)
A implementação atual do serviço de serviços (cadastro de serviços) está em src/Services/OmieServiceService.php.
Métodos já implementados:
listServices(array $filters = []): array
Exemplo de uso
Filtros do listServices
Por padrão, o método envia:
nPagina = 1nRegPorPagina = 100
Você pode sobrescrever esses valores passando o array $filters.
Service de Venda Simples (OmieSimpleSaleService)
A implementação atual do serviço de venda simples está em src/SimpleSale/OmieSimpleSaleService.php.
Métodos já implementados:
addOrder(array $payload): arraylistOrders(array $filters = []): arrayaddObs(array $payload): array
Exemplo de uso
Filtros do listOrders
Por padrão, o método envia:
pagina = 1registros_por_pagina = 100apenas_importado_api = 'N'
Você pode sobrescrever esses valores passando o array $filters.
Testes com Pest
Os testes ficam na pasta tests.
Para rodar:
No Windows (PowerShell), se php estiver configurado no PATH:
Estado atual do projeto
Este SDK está em fase inicial. A parte de contratos e configuração já está pronta.
Próximos passos comuns:
- criar implementação concreta para chamadas HTTP na API Omie
- tratar erros e respostas da API
- adicionar mais testes unitários e de integração
Licença
MIT
All versions of omiephpsdk with dependencies
illuminate/config Version ^12.52
illuminate/container Version ^12.52
illuminate/filesystem Version ^12.52
illuminate/support Version ^12.52
guzzlehttp/guzzle Version ^7.10