API de Apontamentos¶

Disponibilizar API que automatize o apontamento de produção, com a menor interferência possível do Operador da máquina neste processo, integrando assim, o FoccoERP com ferramentas de gerenciamento fabril.

Escopo da Integração¶

Permite realizar o apontamento das ordens de fabricação com outros softwares e integrar os dados retornados com o FoccoERP.
Permite que o analista de PCP acompanhe os apontamentos das ordens de fabricação.
Permite filtrar os apontamentos por ordem de fabricação, centro de trabalho, recurso, operador, data, item.
Permite realiza serviço de apontamento das ordens de fabricação através de ferramentas de apontamento, retornando para o FoccoERP:
- Data de importação da Ordem;
- Número da Ordem;
- Código do Item da Ordem;
- Descrição da Operação;
- Quantidade na operação da Ordem;
- Quantidade apontada na operação da Ordem;
- Quantidade Pendente na Operação da Ordem – Quantidade Apontada;
- Quantidade de Refugo apontada na operação da Ordem;
- Motivo do Refugo no retorno.

Situações não tratadas¶

As situações não tratadas pelo produto estão listadas abaixo:

Operações de retrabalho;
Destinar refugos

Chamadas WebService¶

Autenticação¶

Autenticação

POST

~/Authentication/RequestAccess?User=API&Password={senha usuário API}&AllowNewSession=true

Retorno

{
    "Token": {token},
    "ErrorReason": 0,
    "CustomErrorMessage": null,
    "IsSuccessful": true
}

Logout¶

Logout

POST

~/Authentication/Logout

Header

Authorization

Bearer { token}

Buscar Centros de Trabalho¶

Buscar Centros de Trabalho

POST

~/api/Commands/Manufatura.Engenharia.GetCentrosTrabalhoCommand

Header

Authorization

Bearer { token}

Content-Type

application/json

X-EMPR-ID

{ID da Empresa}

Body (JSON)

skip

Quantidade de registros para “saltar”

take

Quantidade de registros que serão retornados

Retorno

{
    "$values": [
        {
            "Codigo": "10",
            "Descricao": "FURAÇÃO",
            "Empresa": {
                "Codigo": 10,
                "NomeFantasia": "BRASILEIRA S/A (TESDES)",
                "RazaoSocial": "FOCCOERP_ORIG_3_17",
                "ID": 10
            },
            "ID": 39
        }
    ]
}

Buscar Recursos (Máquinas)¶

Buscar Recursos (Máquinas)

POST

~/api/Commands/Manufatura.Producao. GetRecursosIndustriaisByTipoCommand

Header

Authorization

Bearer { token}

Content-Type

application/json

X-EMPR-ID

{ID da Empresa}

Body (JSON)

skip

Quantidade de registros para “saltar”

take

Quantidade de registros que serão retornados

tipoRecursoIndustrial

“ID”: “M”

Retorno

{
    "$values": [
        {
            "$id": "45107",
            "Codigo": "100",
            "Descricao": "APARELHO DE SOLDA  250A TCM 325",
            "Tipo": {
                "ID": "M"
            },
            "ID": 58,
        }
    ]
}

Buscar Ordens de Produção Abertas¶

Buscar Ordens de Produção Abertas

POST

~/api/Commands/Manufatura.Producao.GetOrdensAbertasCommand

Header

Authorization

Bearer { token}

Content-Type

application/json

X-EMPR-ID

{ID da Empresa}

Body (JSON)

getOrdensRequest

"skip": 0,
"take": 10,
"DtEmissGreaterThanOrEqual":"2010-01-01T00:00:00",
"DtEmissLesserThanOrEqual":"2018-06-31T00:00:00",
"CodigoItem":"",
"MascID": "",
"CodMaquina":"",
"CodCentroTrabalho": ""

Retorno

Para buscar as ordens de produção abertas, no body deve conter o filtro abaixo.

Observação

Os campos podem ser adicionados conforme necessidade de filtro.

Atenção para o formato de data.

{
    "getOrdensRequest":
    {
        "Take":1,
        "Skip":0,
        "DtEmissGreaterThanOrEqual": "2015-06-28T00:00:00",
        "DtEmissLesserThanOrEqual": "",
        "CodigoItem": "CANETA",
        "MascaraID": "",
        "CodigoMaquina": "",
        "CodigoCentroTrabalho": "",
        "OrdemID": "",
        "NumeroOrdem": ""
    }
}

Abaixo, um exemplo do retorno:

{"$values": [{
            "Item": {
                "ItemMascara": {
                    "$id": "50981",
                    "Mascara": "AZUL#CILÍNDRICO",
                    "Ativo": true,
                    "Engenharia": {
                        "$id": "50982"
                        "ItemEngenharia": {
                            "PesoLiquido": 0,
                            "PesoBruto": 0,
                            "Cubagem": 0,
                            "ID": 31733},
                        "PesoLiquido": 0,
                        "PesoBruto": 0,
                        "Cubagem": 0,
                        "ID": 204212},
                    "ItemEmpresa": {
                        "CadastroItem": {
                            "Codigo": "CANETA",
                            "DescTecnica": "ITEM INDUSTRIAL C/ ESTR",
                            "Ativo": true,
                            "ID": 31520},
                        "Empresa": {
                            "Codigo": 10,
                            "NomeFantasia": "BRASILEIRA S/A (TESDES)",
                            "RazaoSocial": "FOCCOERP_ORIG_3_17",
                            "ID": 10 },
                        "ItemPDM": {},
                        "Engenharia": {},
                        "Planejamento": {
                            },
                            "ID": 31467}, "ID": 32449
                    }, "ID": 30861
                    },
                "Mascara": "AZUL#CILÍNDRICO",
                "MascaraID": 30861,
                "Engenharia": {},
                "IsItemConfigurado": true,
                "ItemEmpresa": {},
                "Codigo": "CANETA",
                "DescTecnica": "ITEM INDUSTRIAL C/ ESTR"
            },
            "Numero": 1006,
            "Quantidade": 2,
            "DtEmissao": "2016-12-12T00:00:00-02:00",
            "Observacao": null,
            "TipoOrdem": {
                "$id": "50989",
                "ID": "OFM",
                "Type": 
            },
            "Finalizada": false,
            "RoteirosProducao": {
                "$id": "50990"},
            "ID": 400505
        }
    ]
}

Buscar Ordem pelo ID¶

Buscar Ordem pelo ID

GET

~/api/Entities/Manufatura.Producao.OrdemProducao/{ID}

Header

Authorization

Bearer { token}

Content-Type

application/json

Retorno

{ 
"Item": {
        "$type": ,
        "ItemMascara": {
            "Mascara": "AZUL#CILÍNDRICO",
            "Ativo": true,
            "Engenharia": {
                "ItemConfigurado": null,
                "ItemEngenharia": {
                    "ItemEmpresa": null,
                    "PesoLiquido": 0,
                    "PesoBruto": 0,
                    "Cubagem": 0,
                    "ID": 31733},
                "PesoLiquido": 0,
                "PesoBruto": 0,
                "Cubagem": 0,
                "ID": 204212},
            "ItemEmpresa": {
                "CadastroItem": {
                    "Codigo": "CANETA",
                    "DescTecnica": "ITEM INDUSTRIAL C/ ESTR",
                    "Ativo": true,
                    "ID": 31520},
                "Empresa": {
                    "Codigo": 10,
                    "NomeFantasia": "BRASILEIRA S/A (TESDES)",
                    "RazaoSocial": "FOCCOERP_ORIG_3_17",
                    "ID": 10},
                "ItemPDM": {},
                "Engenharia": {},
                "Planejamento": {
                    "ItemEmpresa": {},
                    "ID": 31467},
                "ID": 32449},
            "ID": 30861},
        "Mascara": "AZUL#CILÍNDRICO",
        "MascaraID": 30861,
        "Engenharia": {},
        "ItemEmpresa": {},
        "Codigo": "CANETA",
        "DescTecnica": "ITEM INDUSTRIAL C/ ESTR"
    },
    "Numero": 1006,
    "Quantidade": 2,
    "DtEmissao": "2016-12-12T00:00:00-02:00",
    "Observacao": null,
    "TipoOrdem": {
        "ID": "OFM",
        "Type": 
    },
    "Finalizada": false,
    "RoteirosProducao": {},
    "ID": 400505
}

Buscar Recurso pelo ID¶

Buscar Recurso pelo ID

GET

~/api/Entities/Manufatura.Producao.RecursoIndustrial/{ID}

Header

Authorization

Bearer { token}

Content-Type

application/json

Retorno

{
    "Codigo": "100",
    "Descricao": "APARELHO DE SOLDA  250A TCM 325",
    "Tipo": {
        "ID": "M"
},
    "ID": 58
}

Buscar Centro de Trabalho pelo ID¶

Buscar Centro de Trabalho pelo ID

GET

~/api/Entities/Manufatura.Engenharia.CentroTrabalho/{ID}

Header

Authorization

Bearer { token}

Content-Type

application/json

Retorno

{
    "Codigo": "10",
    "Descricao": "FURAÇÃO",
    "Empresa": {
        "Codigo": 10,
        "NomeFantasia": "BRASILEIRA S/A (TESDES)",
        "RazaoSocial": "FOCCOERP_ORIG_3_17",
        "ID": 10
    },
    "ID": 39
}

Causa de Refugo¶

Causa de Refugo

POST

~/api/Commands/Manufatura.Producao.Apontamento.GetCausasRefugoCommand

Header

Authorization

Bearer { token}

Content-Type

application/json

X-EMPR-ID

{ID da Empresa}

Body (JSON)

skip

Quantidade de registros para “saltar”

take

Quantidade de registros que serão retornados

Retorno

{
"$values":[
        {
            "Codigo": 1,
            "Descricao": "MATÉRIA PRIMA COM PROBLEMA",
            "Empresa": null,
            "ID": 1
        }
    ]
}

Motivos de Refugo¶

Motivos de Refugo

POST

~/api/Commands/Manufatura.Producao.Apontamento.GetMotivosRefugoCommand

Header

Authorization

Bearer { token}

Content-Type

application/json

X-EMPR-ID

{ID da Empresa}

Body (JSON)

skip

Quantidade de registros para “saltar”

take

Quantidade de registros que serão retornados

Retorno

{
    "$values": [
        {
            "Codigo":