API Endpoints
Fracttal →
Start typing to search…

Criar uma entrada em um armazém

post https://app.fracttal.com/api/warehouse_entries_orders/

Através deste serviço web, você pode criar uma entrada para um armazém Fracttal não integrado.

O parâmetro na url warehouse_code é o código do armazém ao qual se deseja realizar a entrada. Pode ser consultado aqui. (campo code)

Os tipos de entrada que podem ser feitos são: Compra e devolução

Entrada para uma compra:

  • Uma compra nova: Neste tipo de entrada, todos os recursos que entrarão no armazém devem ser enviados com suas respectivas quantidades e preços. Neste tipo de entrada, os recursos são atribuídos por padrão o imposto que cada empresa selecionou como padrão.
  • A compra que vem de uma ordem de compra: para este tipo de entrada, a identificação da ordem de compra criada no depósito deve ser enviada. A PROCURADA OU PARCIAL pode ser feita para os recursos que estão associados ao pedido de compra selecionado. Se você quiser fazer uma entrada parcial, você deve enviar a matriz com o código de itens e quantidades que ela terá. No caso de uma entrada total, não é necessário enviar os itens.

Entrada por retorno:

Este tipo de entrada é feito quando os materiais que foram entregues por meio de uma retirada do armazém são devolvidos. Para este tipo de entrada, você deve enviar a identificação da emissão criada no armazém. Ao utilizar este tipo de entrada, você pode fazer uma entrada CHEIA OU PARCIAL dos recursos associados à questão. Se você quiser fazer uma entrada parcial, você deve enviar a matriz com o código de itens e quantidades que a entrada terá. No caso de uma entrada Total, não é necessário enviar os itens.

Exemplo de entrada parcial:

{
"movement_type":"2",
"is_from_movement":true,
"code_user": "25198772-2",
"document":"784",
"note":"Entrada desde una salida por integración",
"items":[
         {
           "code":"HERRA01",
           "qty": "1"
         }
 ]
}

Quando as entradas são feitas por integração, é obrigatório o envio do código de um recurso humano responsável pela transação. Este usuário deve ter uma conta Fracttal criada.

Quando as entradas estiverem relacionadas a movimentos dentro do depósito, as informações do fornecedor, centro de custo e moeda serão automaticamente atribuídas a partir do movimento da fonte (seja de um pedido de compra ou de uma saída). Caso deseje modificá-los, você deve enviar os parâmetros no serviço web.

Parámetros de entrada

Parâmetro Tipo Requerido Descrição
warehouse_code *Texto* Sim Código do Armazém
body *JSON* Opcional JSON com as informações necessárias para a criação da entrada

Parâmetros de Body

A seguinte informação deve ser enviada no body da solicitação.

Parâmetros Tipo Obrigatório Descrição
movement_type *Número* Sim Tipo de movimento: 1 = Compra 2 = Devolução
is_from_movement *Booleano* Opcional É True, caso você queira fazer uma entrada para um movimento existente em Fracttal (ordem de compra ou de saída). False no caso de criar uma nova entrada, entrando manualmente os itens. O valor padrão é falso
document *Texto* Sim Referência da entrada. Se vier de um pedido de compra ou de uma saída dentro da Fracttal.
Para ordem de compra deve-se enviar o *folio_target* da ordem de compra. [Pode ser consultado aqui.](https://api.fracttal.com/reference/consulta-de-ordem-de-compra)
Para devolução deve-se enviar o *document* da saída. [Pode ser consultado aqui.](https://api.fracttal.com/reference/consulta-movimentos-de-saida)

Caso não venha de um movimento, estabelece-se um valor de livre escolha.
code_user *Texto* Sim Código do usuário responsável pela transação. Código do usuário associado ao recurso humano responsável pela transação. [Pode ser consultado aqui.](https://api.fracttal.com/reference/consulta-de-recursos-humanos) (campo *code*)
code_supplier *Texto* Opcional Código do terceiro que é classificado como fornecedor. [Pode ser consultado aqui.](https://api.fracttal.com/reference/consulta-de-terceiros) (campo *code*)
value_cost_center *Texto* Opcional Código do centro de custo. (Não é necessário enviá-lo se a descrição do centro de custos for enviada). [Pode ser consultado aqui.](https://api.fracttal.com/reference/consultar-centros-de-custo) (campo *value*)
description_cost_center *Texto* Opcional Descrição do centro de custos. (Não é necessário enviá-lo se o valor do centro de custo for enviado). [Pode ser consultado aqui.](https://api.fracttal.com/reference/consultar-centros-de-custo) (campo *description*)
note *Texto* Opcional Notas de entrada
items *Array de Json* Sim
Parâmetro Tipo de campo Requerido Descrição
code Text Sim Código do recurso a adicionar à entrada (deve estar associado ao armazém)
qty Text Sim Quantidade do recurso
unit_cost Real Sim Custo unitário.
tax_name Texto Opcional Nome_do_imposto. Se não enviado, o imposto padrão da empresa é associado empresa
serial_numbers Array de string Opcional Só esta informação deve ser enviada quando o recurso associado é controlado em série. A mesma quantidade de série e quantidade de recursos deve ser enviada

Detalhes dos objetos itens

Parâmetro Tipo Descrição
code *Texto* Código do item. Pode ser consultado aqui. (campo *code*)
qty *Número* Quantidade em movimento
unit_cost *Número* Custo unitário

Parámetros de salida

Parâmetro Tipo Descrição
folio_target *Inteiro* ID do movimento
date *Date* Data da entrada
description *Texto* Nota de entrada.
document *Texto* Referência
id_third_party *Texto* id del terceiro
third_parties_name *Texto* Nome do terceiro
third_parties_code *Texto* Código do terceiro
id_cost_center *Texto* Id Centro de Custos
costs_center_value *Texto* Valor do centro de Custos
costs_center_description *Texto* Descrição do centro de Costos
folio_source *Texto* Id do movimento da fonte do almazem
date_create *Texto* Data de criação do movimento
id_priority *Texto* Id Prioridade
priorities_description *Texto* Prioridade
id_currency *Número* id da Moeda
currency_description *Texto* Descrição da Moeda
currency_symbol *Texto* Símbolo da Moeda
movements_states_description *Texto* Descrição do estado do movimento
movement_details *Json array* Lista de itens que foram associados à entrada
  1. Exemplo Nova Entrada sem movimentos associados:

Requisição: (POST)https://app.fracttal.com/api/warehouse_entries_orders/002

{
    "movement_type":"1",
    "code_user": "25198772-2",
    "code_supplier":"terc-00123e3",
    "value_cost_center":"500000000",
    "document":"In_7456",
    "note":"Entrada por integração",
    "items":[
    	{
    	    "code":"AFL_056",
            "qty": "5",
            "unit_cost":"135",
            "serial_numbers":["A5402","A5403","A5404","A5405","A5406"]
    	},
    	{
    	    "code":"4890255A-R1",
            "qty": "20",
            "unit_cost":"750"
        },
        {
    	    "code":"MMRVH6900",
            "qty": "8",
            "unit_cost":"42533"
        },
        {
    	    "code":"38079",
            "qty": "50",
            "unit_cost":"5794"
        }
    ]
}
{
    "success": true,
    "message": "200",
    "data": {
        "id": 3977,
        "folio_target": "MOV206ANTO",
        "date": "2019-10-18",
        "description": "Entrada por integração",
        "document": "In_7456",
        "id_third_party": 2062,
        "third_parties_name": "adecco",
        "third_parties_code": "terc-00123e3",
        "id_cost_center": 421,
        "costs_center_description": "Fracttal 2019",
        "costs_center_value": "500000000",
        "folio_source": null,
        "date_create": "2019-10-18T17:13:50.008899+00:00",
        "id_priority": null,
        "priorities_description": null,
        "id_currency": 7,
        "currency_description": "PESO CHILENO",
        "currency_symbol": "$",
        "movements_states_description": "IN",
        "movement_details": [
            {
                "id_item": 5075,
                "items_description": "ACEITE VALVOLINE EURO  15W40 { 38079 } VALVOLINE",
                "code": "38079",
                "units_description": "LITROS",
                "qty": 50,
                "unit_cost": 5794,
                "total_cost": 344743,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 12437,
                "items_description": " FILTRO DE  MALLA HAGIE 690629 MMRVH6900  HYUNDAI { MMRVH6900 }",
                "code": "MMRVH6900",
                "units_description": "UNIDAD",
                "qty": 8,
                "unit_cost": 42533,
                "total_cost": 404914,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 5470,
                "items_description": "CORONA Y PIÑON EJE CORTO KIT 11X38 MFSerie 300 11X38 Fabricante { 4890255A-R1 }",
                "code": "4890255A-R1",
                "units_description": "UNIDAD",
                "qty": 20,
                "unit_cost": 750,
                "total_cost": 17850,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 122,
                "items_description": "AFLOJATODO  ACOMPA015 { AFL_056 } LUBRITEX S.A",
                "code": "AFL_056",
                "units_description": "Maquina",
                "qty": 5,
                "unit_cost": 135,
                "total_cost": 803.25,
                "tax_name": "IVA",
                "tax_rate": 19
            }
        ]
    },
    "total": 1
}
  1. Exemplo Nova Entrada de um pedido de compra :

Requisição: (POST)https://app.fracttal.com/api/warehouse_entries_orders/002*

{
    "movement_type":"1",
    "is_from_movement":true,
    "code_user": "25198772-2",
    "document":"OC34ANTO",
    "note":"Entrada desde orden de compra por integración"
}
{
    "success": true,
    "message": "200",
    "data": {
        "id": 3998,
        "folio_target": "MOV224ANTO",
        "date": "2019-10-18",
        "description": "Entrada desde orden de compra por integración",
        "document": "OC36ANTO",
        "id_third_party": 143,
        "third_parties_name": "FRACTTAL SPA",
        "third_parties_code": "036854",
        "id_cost_center": 22,
        "costs_center_description": "SUM3015",
        "costs_center_value": "",
        "folio_source": null,
        "date_create": "2019-10-18T19:27:07.279185+00:00",
        "id_priority": null,
        "priorities_description": null,
        "id_currency": 7,
        "currency_description": "PESO CHILENO",
        "currency_symbol": "$",
        "movements_states_description": "IN",
        "movement_details": [
            {
                "id_item": 5470,
                "items_description": "CORONA Y PIÑON EJE CORTO KIT 11X38  MFSerie 300 { 4890255A-R1 } Fabricante",
                "code": "4890255A-R1",
                "units_description": "UNIDAD",
                "qty": 45,
                "unit_cost": 980,
                "total_cost": 52479,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 20,
                "items_description": "LAINAS DE CALIBRACIÒN { 0000AC-21 }",
                "code": "0000AC-21",
                "units_description": "JUEGO",
                "qty": 5,
                "unit_cost": 6800,
                "total_cost": 40460,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 5075,
                "items_description": "ACEITE VALVOLINE EURO  15W40 { 38079 } VALVOLINE",
                "code": "38079",
                "units_description": "LITROS",
                "qty": 5,
                "unit_cost": 6894.86,
                "total_cost": 41024.4,
                "tax_name": "IVA",
                "tax_rate": 19
            }
        ]
    },
    "total": 1
}

TESTE DE CONEXÃO

Language